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PREFACE 



This document is organized as a reference manual. The DAP- 16 and DAP- 16 Mod 2 
Assembly Languages and Assemblers used on Series 16 general purpose computer systems 
are described. Subject areas include pseudo-operations (instructions to the assembler rather 
than instructions to be assembled into the program), the mixing of FORTRAN and DAP- 16 
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No. BX47, Doc. No. 70130072156 - M-490) and the 316/516 Operators' Guide (Order No. 
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SECTION I 
INTRODUCTION 



SCOPE OF MANUAL 

This manual describes the DAP- 16 and DAP- 16 Mod 2 Assembly Languages and 
Assemblers for use on Honeywell Series 16 general purpose computer systems. DAP-16 
Mod 2 is an extension of the DAP-16 Assembly Language which is supported only on the 
DDP-516 and H316 computers. All existing source programs for these computer systems 
will assemble correctly using the DAP-16 Mod 2 Assembler. 

SUPPORTING PROGRAMS 

Source programs written in DAP-16 language may be processed by several supporting 
programs. Each provides the programmer with a specific tool helping him toward the goal 
of producing an efficient, error-free object program. 

The DAP-16 Assembler is the primary program for processing the DAP-16 Language. 
This program produces object text for eventual loading into the computer along with a listing 
of the source program and the assembler's action on each statement. This program is 
discussed in Section II of this Manual. 

The Macro Preprocessing Program permits processing of a DAP-16 source program 
with several additional statement types. These statements allow predefined blocks of source 
text to be modified and inserted in a copy of the source program. The term " Macro" 
implies that one statement produces several instruction blocks. These blocks, called 
macro-expansions, may be defined within the program or may come from a macro library. 
These macro- expansions are also modified to include appropriate symbols for each instance 
of use. Through use of the Macro Preprocessing Program the programmer can significantly 
reduce the number of statements to be written. With this program, the user can also define 
a new language which suits his needs more closely than DAP-16. Macros also aid "instal- 
lation standard" code for system interfacing where the macro library contains the critical 
code for connecting user programs with the operating system and/ or I/O equipment. The 
output of the Macro Preprocessing Program is a DAP-16 source text suitable for use by any 
of the programs discussed in this Manual. However, the Macro Preprocessing Program is 
discussed in a separate Manual, titled MAC Macro Preprocessor Programmers Reference 
Manual . 

The Concordance Program operates upon a DAP-16 source program in a manner 
similar to the operation of the DAP-16 Assembler. Its Output is a cross-reference table 
listing each symbolic name and literal and the source locations of every reference to them. 
This program is discussed in a separate Manual, titled XREF Concordance Program Pro- 
grammers Reference Manual. 
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The Update Program allows manipulation of a source program within the computer. 
This program is discussed in a separate manual titled 016-XREF, SSUP and MAC Source 
Language Processors. 

The discussion so far has concerned the assembly process prior to loading. 
However, a loading program is logically inseparable from an associated assembler, 
because the path from assembly language code to loaded program must pass through both 
the assembler and the loader. The loading programs used with either DAP- 16 Assembler 
are described in Section II of this manual. 

Figure 1-1 illustrates the processing of a DAP- 16 source program by these support- 
ing programs. Note that Figure 1-1 references another useful program, namely, the 
Write and Load Program. This type of program provides a core dump which is easily 
reloaded without the use of a loader, providing a handy method of storing completed pro- 
grams between use. 
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Document Doc. No. 
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SECTION II 
DAP- 16 ASSEMBLER 

The DAP-16 Assembler provides the programmer with the means for generating 
linkages between a source program and others which are assembled or compiled separately. 
The linkage is actually performed by the Loader. Each point in a program to be linked is 
assigned an external symbolic name which is then referenced by any other program requesting 
use of that link point. The Loader will not complete its job until all references to external 
names in the program being loaded have been satisfied. 

The Assembler produces two independent outputs. The first is the object text which 
is further processed by the Loader, and the second is the assembly listing. The listing 
serves to inform the programmer of the actions taken by the Assembler so he can eliminate 
errors and make other changes. The assembly listing also carries programmer comments 
and other documentation. 

The assembly listing is printed during the final pass. Thus the listing from a two- 
pass assembly contains more information than that from a one-pass assembly, namely the 
definition of all symbols encountered anywhere in the program. Object tapes from the two 
types of assembly may be loaded by the same Loader. 

The DAP-16 Assembler must be linked to a number of support programs which permit 
it to operate independent of associated input/ output devices and to operate either alone or 
under an operating system. The input/ output system can use a general supervisor, allowing 
successive assemblies to be conducted with different devices, or can be formed from one of 
several dedicated supervisors which use a preselected combination of input/ output devices. 
Such a dedicated supervisor is useful for systems where standard devices are always used 
or the available memory is limited. Note that the DAP-16 Assembler is referred to as an 
Assembler System in Figure 1-1. The specific programs comprising this system are 
described in Section V and VI. 

The Assembler may make either one or two passes over a source text depending on 
how the assembly is initiated. 

LOCATION COUNTER 

The DAP-16 Assembler maintains a Location Counter which points to the memory 
location for which a word is currently being assembled. This counter is relocatable or 
absolute depending on the mode of assembly and is used in defining symbols appearing in 
the Location Field and in establishing a value for asterisks appearing in the Address Field. 

After each word (instruction) is assembled, the Location Counter is normally incre- 
mented by one. 



2-1 



TWO- PASS ASSEMBLY 

In this mode of assembly, the DAP- 16 Assembler reads the source program twice, 
first to develop a dictionary of symbols, and a second time to assemble the object program 
by referencing the Symbol Table (Dictionary). Each entry in the Symbol Table is three 
words in length. Therefore, the maximum number of symbols that may be handled is one- 
third of the number of locations available (usually all of the locations between the highest 
location used by the assembler and the highest location of memory). During pass two, 
DAP-16 assembles and outputs the Object Text and Assembly Listing. Each source line is 
processed before the next line is read. Figure 2-1 illustrates the processing of each line. 

During the processing of a line, the operation mnemonic is first examined. If a 
standard machine operation is being conducted, the proper code is inserted in the object 
text. If a pseudo operation is specified (calling for some action by the assembler rather 
than specifying an operation code) the proper action is taken. The address field is then 
processed and the proper value inserted in the object text. The assembly listing image is 
formed and any errors detected in the line are flagged at the left end. 

ONE -PASS ASSEMBLY 

The development of the Symbol Table and the assembly of the Object Program are 
accomplished simultaneously in a one-pass assembly. Any symbols not defined when en- 
countered are assigned an internal symbol number. The printed output shows two asterisks 
in the field which would contain the symbol value. When the Assembler determines the 
assigned value of a symbol this information is included in the object text. The Loader then 
uses this information to finish assembling the instruction words in core. 

LOADERS 

A Loader processes object text to form a core image and places this image in memory. 
Memory references within the program are resolved and indirect links generated as required. 
References to external names (which are assembled without an address) are also resolved. 
The Loader operates in the mode specified by the programmer in the source text. Loaders, 
which are large and complicated programs, are as important to the process of generating 
an executable core content as Assemblers and Compilers. 

There are two kinds of Loaders available, namely linking and non-linking. LDR-APM, 
SLDR-A, SLDR-C, and SLDR-P are the linking Loaders; and MINILOAD is the non-linking 
Loader. 

LDR-APM is the full Loader, and with proper support programs can load object text 
from any medium or mix of media. Object Text from either one or two-pass assemblies 
can be loaded as well as FORTRAN Object Texts with all external references correctly 
linked. 

SLDR-A and SLDR-P are smaller linking loaders for paper tape Object Texts loaded 
through en ASR teletypewriter and the high-speed tape reader respectively. SLDR-C is the 
small linking loader for punch card object text. These Loaders can load object text from 
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Figure 2-1. DAP-16 Processing of a Line 
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two-pass assemblies and FORTRAN compilations, but not from one-pass assemblies. 
Again, all external references are correctly linked. 

MINILOAD is the smallest of the Loaders, and loads object text from any medium in 
conjunction with appropriate support programs. The object text must be derived from two- 
pass assemblies. One-pass assemblies and FORTRAN compilations cannot be loaded. 
Furthermore, only one mode of loading must be used in any one program. Since no linkages 
are made to external names, these must be handled by the programmer as absolute refer- 
ences. 

MODES OF OPERATION 

There are three assembly and loading modes which may be specified to and through 
the DAP- 16 Assembler by the programmer. These are illustrated in Figure 2-2. The 
descriptions of the pseudo-operations which implement the three operating modes are 
located in Section III. 
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DEFAULT MODE 
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LOAD 
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Figure 2-2. Assembler and Loader Operating Modes 

Desectorizing Modes 

In the two Desectorizing Modes, the Loader handles all intersector references by 
generating indirect address links (vectors) when necessary. These links are located in 
sector zero unless the programmer has specified location elsewhere by the use of a SETB 
pseudo-operation. Because in general the programmer may not be aware of which instruc- 
tions will have indirect bits set by the Loader, he must be careful in modifying the address 
of instructions during program execution. 

The Loader may handle intersector links for either normal addressing or extended 
addressing. The EXD pseudo-operation causes the Loader to form 15-bit indirect address 
links, while the LXD pseudo-operation returns the Loader to the normal 14-bit mode. 
These pseudo-operations should be used in conjunction with the EXA and DXA machine 
operations. The effect of EXD and LXD may also be forced by the operator at load time. 
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Desectorizing and Absolute Mode. -- This mode is the Assembler default mode for program 
loading unless one of the other modes is specified. The location at which the program is 
loaded is fixed by the ORG pseudo-operation, which must be assembled before any locations 
are assigned. This location cannot be changed at load time. 

Desectorizing and Relocatable Mode. -- This mode differs from the Desectorizing and 
Absolute Mode in that addresses may be relocated at load time. The REL pseudo-operation 
initiates entrance into this mode. The ABS pseudo-operation may be used to return to 
Desectorizing and Absolute mode. 

Any symbolic names assigned in the relocatable portion of a program are considered 
relocatable. Such symbols may not be treated in ways which the Loader cannot handle, 
(e. g. , being added together). 

Load Mode 

In this mode all intersector links are assumed to be handled by the object program. 
Warning flags are posted whenever a link is required. The Loader will generate the link if 
this program is loaded. This feature provides a useful tool for debugging, timing, or 
loading a program when the programmer must give cross sector linkages special treatment. 
Addresses are absolute (there is no relocatable load mode). The Load Mode is entered 
with the LOAD pseudo-operation and continues for the duration of the assembly. 

CODING DAP- 16 PROGRAMS 

Symbolic Names 

DAP-16 uses Symbolic Names to identify numerical values computed by the Assembler. 
These values are normally the addresses of instructions or data. The assembler maintains 
a Symbol Table that permits substitution of the proper value for any reference to a Symbolic 
Name. 

The most common method of assigning values to Symbolic Names is to enter the 
symbol to be named in the location field of the DAP-16 coding form. The assembler will 
assign the value of the Location Counter to that symbol when that line is processed. 
Multiple definition is an error. Symbols may also be assigned values by the EQU and SET 
pseudo - ope rations . 

Allowable symbols consist of from one to four characters from the 37-character set 
A-Z, 0-9, and $, with at least one of the characters in a symbol being alphabetic. The 
dollar sign can not be the first character, and generally should be used with care since it 
usually signifies system programs. Six-character symbols may be used for referenced 
external names in the address field. 

The following symbols are legitimate: 

LOOP 

ST2P 

A$ 

CENTER (an external name) 
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DAP- 16 Coding Form 

The DAP-16 Assembler's input support programs accept input in either of two for- 
mats, namely, fixed-field and tab-field (paper tape input only). In the fixed-field format 
each source line is an 80-character field (a punched card image). Each data field within 
this 80-character field has a specified location. The input drivers convert a tab-field for- 
mat to this fixed-field format. Each data field may be terminated by a backslash charac- 
ter ( \, '334), and the source line may be terminated by a carriage return. 

Figure 2-3 shows a DAP-16 Assembler Coding Form. The five fields that appear 
on this form are: Location, Operation, Operand, Comments, and Identification. The 
circled t's in columns 5, 11, and 29 signify that a backslash to the left of that column will 
be interpreted as a tab to the column following the marked column. Similarly, the circled 
CR in column 72 indicates that the comments field may be terminated by a carriage return. 
Furthermore, Table 2-1 shows in detail how the assembler defines and interprets these 
fields in both the fixed-field and tab-field formats. Notice that each field, with the excep- 
tion of the Comments and Identification fields, is terminated by blanks. Therefore, their 
contents must be left-justified and cannot contain embedded blanks. If, for example, the 
statement XI LDA X2+7 were written as XI LDA X2 + 7, the assembler would interpret 
this statement as XI LDA X2 and assume that + 7 was a comment: 

i " '■ ■» INTENDFO STATEMENT 

■■'''■"< OIU'O ij 02 01427 L^A X?*7 

n l r '5 * CAUSES INCORRECT ACTION' IF WPITTFN AS 

(11.06 01 31 0? 01420 |_nA X? + 7 

Text Examples 

The examples in this manual are shown in the form of assembly listings which are 
described in detail at the end of this section. The first few examples present both the 
coding form and the assembly listing to show the correspondence of the fields. See 
DAP-16 ASSEMBLY LISTINGS near the end of this section for a description of the fields 
generated to the left of what the programmer has written. 
Location Field 

Each time a symbolic name is encountered in the location field it is entered into the 
symbol table along with -the value of the location counter at the time the name was encoun- 
tered. Thus, the location field is used to name instructions or data for later reference. 
In the second pass of the assembler (or the first pass for one-pass assemblies), the sym- 
bolic name is replaced by its value as found in the symbol table. In addition, the location 
field can sometimes be used in other ways by pseudo-operations. References to multiply 
defined symbols are arbitrarily assigned to the first definition. 

As asterisk in column 1 of the location field signifies that the entire line is a com- 
ment, which is printed on the output listing but otherwise ignored. The first line in the 
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assembly (whether it is a comment or not) is used as a header for all pages in the 
assembly listing. 

Operation Field 

This field contains the abbreviation (mnemonic) of an operation or pseudo-operation. 
If a given abbreviation is not recognized or is not legal on the object machine, an error is 
flagged. 

TABLE 2-1. DAP- 16 ASSEMBLER FORMATS 



Field 


Fixed-Field Format 


Tab-Field Format 


How Assembler 
Handles Field 


Location 


Column 1 to first blank 
column following 


First column to first 
blank or backslash 
following 


Symbolic name for 
address of this 
operation or data 


Operation 


Column 6 to first blank 
column following 


End of location field 
to next blank or back- 
slash 


Abbreviation for 
operation or 
pseudo- ope ration 


Operand 


Column 12 to first 
blank column follow- 
ing 


End of operation field 
to next blank or back- 
slash 


Variables or data 


Comments 


First blank column 
following column 12 
to column 44 


First 15 characters 
between end of 
operand field and 
carriage return 
character 


Printed on listing, 
otherwise ignored 


Extended 
Comments 


Columns 45 to 72 


Any remaining 
characters before 
carriage return 
character 


Printed on listing, 
except overprints 
last character on 
ASR 


Identification 


Columns 73 to 80 


Part of comments 
field 


Printed on listing, 
otherwise ignored 



An asterisk (*) used in the operation field of a memory reference line (immediately 
following the operation code) signifies that the indirect bit is to be set. For example, to 
store the contents of the A-register indirectly through the location at symbolic name XNA 
(i.e. , to store at the location pointed to by XNA), the following code would be written: 



LOCATION 



© 



OPERATION 



■<D 



OPERAND- FIELD 



® 



COMMENTS 



T 
35)36 |37|3a|39|4CHlt42|43|44|45 



10 



12 



13 



14 



15 



16 



17 



18 



19 2021 22 23 



24 



25 26 27 28 29 30 



31 



32 



3334 



ST A* 

J l l f M L_ 



X.*A . 



I I I L _J I - 



—4 1 L. 



I ' I I 1 I l_ 



_l_J — u 

J I L_J 1 j 1 1 1 1_ 



|ND I RfcT STORE 



J I 1 1 1 L 



-l — u 
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The assembly listing of this line would appear as follows: 

0010 03407 -0 04 03244 STA* XMA INDIRFCT STPRF 

The assembly listing always shows a minus sign for indirect references as shown 
above. 
Address Field 

The address field is used in several ways, but generic operations do not use this 
field at all. As an example of the use of this field, consider two's complementing the cur- 
rent value of the A-register: 



LOCATION 


. 


OPERATION 


■® 


OPERAND FIELD ® 


COMMENTS 


1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


II 


12 


13 


14 


15 


16 


17 


18 


19 20 21 22 23 24 25 26 27 28 29 3031 32 33 343536 37 3839 4C 41 


1 

42|43 






T.CA , 




i i i i i i i I i l i i 


^J^ii^LAMJ^L, 


14 I 




— i — i — t — i — 




i l i i I i i i i i i i i — i J — 1_. J — i 


.1111 II | 1 1 1 1 1 1 ! 



0011 06654 



14Q407 



TCA 



2S COMPLEMENT 



Shift instructions use the address field to specify the number of bit positions to 
shift. For instance, a 4-bit logical right shift is coded as: 



LOCATION <D 



12 3 4 



OPERATION ® 



6 7 8 9 10 



*-,6, fi, 



-i — i — i — l 



OPERANP FIELD 



® 



12 



13 



14 



15 



17 



18 



I9 20ZI 22 23 



24 



25 26 27 28 29 30 



_l 1__J I I L.._L_J — 1_ J 1 1 1 1 1. _i 1- 



. J J 1 1 I I I \ — I — 1 — J — I— I — I — I — 1 — t- 



COMMENTS 



31 32 33 34 3536 37 38 39 4C 41 42143*4 



■taiA-xLJL.A , *," ■ ' , F . T 



■ i i i i i i i i i i i — 1_ 
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0018 0?763 0404 74 LGR 4 THIS IS A SHIFT 

In input/output instruction lines, both the value of the function and the controller 
address may be coded as a single variable or an expression to be evaluated. This is often 
an octal number coded with an apostrophe. However, it is recommended that a symbol be 
used (see SET and EQU Pseudo-Operations in Section III). For instance, before using the 
ASR (controller address = '04), it must be enabled in the proper mode. The function code 
for enabling in the output mode (applicable to ASR) is '01. Therefore, .the instruction for 
enabling the ASR in the output mode may be coded numerically as: 



LOCATION ® 



12 3 4 



OPERATION 



.© 



6 7 8 9 10 



C P 



OX 



-1 — l " l " l 



OCA 



&K 



CP 

II I 1_ 



OPERAND- FIELD 



© 



12 



13 



14 



15 



16 



17 



18 



' / 4 

ri ' ri 7 i 



-J 1— J I I L_ 



/ H 



-I — I — I— J | i_ 



10 + ' V 

' i " ± v i T i l_Ll 



192021 2223 



24 



25 26 272829 3031 



^fL^QJLttMJl 



COMMENTS 



32 



3334 



35 36 3738 394041 



tin 



_i — « i i i_ 



-i — i — i — i — i i i_ 



-I — I u 



J I i. 



J 1 I I ! I I 



The first line is listed as: 

0014 07667 14 0104 oCP '0104 ASR OUTPUT 

The address field for memory reference instructions contains two subfields. The 
first subfield specifies the address to be used in the instruction. For example, loading 
the A-register with the contents of the memory cell at symbolic location CEX would be 
coded as follows: 
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LOCATION 



(D 



OPERATION ® 



OPERAND FIELD 



© 



to| 



COMMENTS 



T 
3S|36[37l3a|39|4C|4l |42|43|44|4S 



12 3 4 



6 7 8 9 10 



13 



15 



18 



I9 2d2l 22 23 



24 



25 26 272829 3031 32 



33 34 



L ,t>A , 



c e x 

JU Ll_L 



J L L._l__l_ 



_1 1 1 L— I- -J 1_ 



.J I L ...L-J. — L._L_4. ._!._ 1 I l_4_ 



and assembled as: 

0020 0*202 02 04221 LDA CEX 

In the example above, the second subfield is null. However, when used, the second sub- 
field usually specifies that the index bit is to be set in the assembled line. A value of 
or null designates no indexing; a value of 1 designates indexing. All other values are 
errors. Also, the two subfields are separated by commas. For example, storing the 
contents of the A-register in the memory cell at the address which is the sum of the sym- 
bolic value CEX and the contents of the X-register at the time this STA instruction is 
executed would generate the following line on the listing: 

0022 04207 1 04 04221 STA CEX.l 

The assembly listing shows the index bit as or 1 for memory reference lines. Pseudo- 
operations can use the address field in a number- of ways, some of which allow division 
into many subfields separated by commas. 

Expressions. -- The address field generally contains a symbolic algebraic expression to 
be evaluated, with the result of the evaluation being passed to the loader through the 
object text. Within the object text, such an expression may be either absolute or 
relocatable. 

Only plus and minus operators are allowed. Furthermore, all elements of the 
expression must be constants or symbols present in the symbol table by the end of the 
final pass. Arithmetic may not be performed on external symbols. No indication of 
overflow is given. The following examples show both addition and subtraction. In the 
third line, indexing is also specified. 



moi 


06072 





2 


0625? 


IDA 


DATA+S 


0102 


6 7 3 





6 


06244 


AOD 


DATA-1 


n 1 3 


06074 


1 


04 


615 4 


STA 


RRLT+40,1 


0104 


6 7 3 


-0 


01 


6 3 7 3 


J MP* 


NFXT+2 


0105 


6 7 6 





00 


)170 


DAC 


DATA-RSLT+23 
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Absolute and Relocatable Symbols. -- Symbols defined within relocatable program seg- 
ments are relocatable. Other symbols and all constants are absolute. In the following 
example the retrieval of the contents of core location 0002 is implemented irrespective 
of where the instruction resides or is relocated in core. 

0018 03717 02 00002 LHA 2 

Special Elements. -- The asterisk is used as an element by itself, and three other sym- 
bols — the apostrophe ('), the dollar sign ($), and the equals sign (=) — modify the ele- 
ments they precede. 

The DEC and DBP pseudo-operations allow the letters B and E to be used in the 
address field to specify the position of binary and decimal points (these pseudo-operations 
are discussed in Section III). 

Asterisk. -- The single asterisk is a variable which always has the value of the location 

counter. For example: 

0026 0^615. 01 04614 jmp »-l 

means jump to the previous instruction. The two following examples have the same effect, 
a jump to symbolic location CONT: 

0030 00462 01 00464 JMP »*2 

0031 00463 101000 NOP 

0032 00464 01 00501 JMP CONT 



0077 00462 01 00464 JMP x3 

0078 00463 101000 NOP 

0079 00464 01 00501 X3 JMP CONT 

Double Asterisk. -- The double asterisk is assembled as zero. Normally the program 
will set the address during execution. 

0030 01347 01 00000 JMp «» 

The example above might be used in a program in which the location to be jumped to was 
unknown before assembly. The loader places zero in the 9-bit address and 1-bit sector 
fields and handles the index and indirect bits normally. However, if this instruction were 
assembled in sector rather than sector 1, the sector bit would be one, because the 
referenced location, location 0, is in the same sector as the instruction. 
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Apostrophe (Octal Numbers). -- An Apostrophe preceding a number signifies that the number 
is to be evaluated as an octal number. The following examples yield the same result: 

0037 05164 02 00200 LDA '200 



0022 05164 02 00200 LDA 128 

The minus sign for negative numbers should follow the apostrophe, e.g. , '-60 = -48, and 
the minus operator in expressions should precede the Apostrophe; A-'60 is valid but A+'-60 
is not. 

Dollar Sign (Hexadecimal Numbers). a -- A Dollar Sign preceding a number signifies that the 
number is to be evaluated as a hexadecimal number. The following examples yield the 
same result: 

0034 00213 0? 00017 LDA $F 

0041 00213 02 00017 LDA 15 

0026 00213 02 00017 LDA '17 



The minus sign for negative numbers should follow the Dollar Sign, e.g. , $-30 = -48. 
The minus operator in expressions should precede the Dollar Sign; A-$30 is valid but 
A+$-30 is not. 

Equal Sign (Literals). -- The use of constants in calculations is done conventionally by 
storing a constant as data and writing the data name in the Address field. When 
reading the listing, the value of the constant is not apparent from its name. However, by 
using a literal (expressed as the value of the constant preceded by an equal sign), the same 
result is achieved except that the name of the constant now gives its actual value. There 
are two additional advantages to use of literals. First, the storage location of the literal 
becomes the concern of the Assembler and Loader rather than the object program (i.e. , a 
literal is self- defining). And second, all references to a literal of the same value refer 
to the same location, even though the programmer may not remember that he had made 
more than one use of that value or even that the form of the literal is different. 

Evaluated literals are stored in the Symbol Table along with other symbols. 



DAP- 16 Mod 2 only. 
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The following examples all achieve the same effect, namely loading of a word composed 
of all ones (-1 in twos complement notation) into the A Register. The programmer controls 
the location of the -1 word in the first case, but the Assembler controls location in all other 
cases. In any case, the address in the assembled instruction is the address of a word 
containing -1. 

0039 01306 02 01323 IDA Ml 

0043 01323 177777 Ml DEC -1 

0047 01306 0? 01344 |_DA =-1 



0051 01306 0? 01344 |_DA 



0055 01306 02 01344 LDA =S-1 



0059 01306 02 01344 LDA ='177777 



The DEC pseudo-operation, as used above, assembles a word with the indicated decimal 
value (-1 in this case). 

USASCII Literals. -- To specify a USASC II literal the form =A is used. The following 
example implements loading of a 16 -bit word containing C and $ ('141644) into the A- 
Register: 

0045 00456 02 00563 LDA =AC$ 



DAP- 16 ASSEMBLY LISTINGS 

The printed output of DAP- 16 Assembler System is an Assembly Listing containing 
the source program as it was read along with the action taken by the assembler. Figure 2-4 
illustrates a sample listing. 

The first column contains the line record number of the source statement. The next 
column contains the value of the Assembler Location Counter (octal). The third column 
shows, in octal, the binary word assigned to the location. The parts of the word are 
broken up differently for different categories of instruction. Fifteen bits of address infor- 
mation are included in memory reference instructions and the Loader uses these fifteen 
bits to determine the ten bits of address information to be loaded into the instruction. The 
three modes of loading cause the Loader to modify these fifteen bits in three different ways. 
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Note the following features of Figure 2-4. 

a. Line 1 contains an asterisk in the location field, causing DAP- 16 to treat the 
entire line as remarks. 

b. Line 2 contains a pseudo-operation (ORG) which sets the DAP- 16 location counter 
to octal 1000, the starting address of sector one. 

c. The expression in the variable field in line 3 means the current value of the loca- 
tion counter, plus one. Consequently, DAP- 16 has written octal 1001 into the 
address field of the instruction word assigned to this location. 

d. The symbol in the left margin of line 5 is a diagnostic signifying that a memory 
reference instruction (LDA) has an empty address field. Diagnostics are covered 
in more detail in Section III. 

e. Indirect addressing is specified in line 5, and indexing is specified in line 8. 

f. In line 10 the programmer has entered the number of shifts desired in an LGL 
instruction. DAP-16 has generated the necessary TWOs complement form in the 
object program. 

g. The literal pool starts in line 11 and continues until all three literals called for 
have been satisfied. 



0001 






* SAMPLE 


ASSEMPLY LISTING 


0002 








ORG 


512 


0003 


010 


0? 01001 


STRT 


LDA 


* + l 


0004 


oioni 


04 010 




STA 


»-l 


0005 


01002 


-0 U? 000 




LDA* 




0006 


01003 


6 01012 




ADD 


= 15 


0007 


01004 


06 01011 




ADD 


= •15 


0008 


01005 


1 04 00700 




STA 


STRT-64,1 


0009 


01006 


o 02 moio 




LDA 


= •-■5 


0010 


010 7 


0414 76 




LGL 


2 


0011 


01010 
01011 
01012 


1777/3 
000015 
000017 




END 





(Performs no useful function. See text for discussion of handling of fields.) 

Figure 2-4. Assembly Listing 
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SECTION III 
PSEUDO-OPERATIONS 



DAP-16 pseudo-operations are instructions to the Assembler rather than instructions 
to be assembled into the program. Table 3-1 lists the abbreviations (mnemonics) for these 
instructions in the order of discussion. The most basic pseudo -operations are preceded 
by a checkmark. 



TABLE 3-1. PSEUDO-OPERATIONS 



Abbreviation 



CFx 

v/rel 

ABS 
LOAD 
\/ORG 

FIN 
MOR 

VEND 



EJCT 

LIST 

NLST 



EXD 
LXD 
SETB 

VEQU 
SET 



\/DAC 

\/dec 

DBP 
\/0CT 



Meaning 



ASSEMBLY -CONTROLLING 
PSEUDO-OPERATIONS 

Computer Configuration 

Relocatable mode 

Absolute mode 

Load mode 

Origin 

Assemble Literals 

Operator Action Required 

End of Source Program 

LIST-CONTROLLING 
PSEUDO-OPERATIONS 

Start at top of page 

Generate assembly listing 

Generate no assembly 
listing 

LOADER -CONTROLLING 
PSEUDO-OPERATIONS 

Enter extended 
desectorizing 

Leave extended 
desectorizing 

Set base sector 

SYMBOL-DEFINING 
PSEUDO-OPERATIONS 

Give a symbol a permanent 
value 

Give a symbol a temporary 
value 

DATA-DEFINING 
PSEUDO -OPERATIONS 

Address constant 

Decimal constant 

Double precision constant 

Octal constant 



Abbreviation 



HEX 

y bci 

VFD 



BSS 
BES 
V BSZ 
COMN 
SETC 



ENT 
\/sUBR 

EXT 
\/,XAC 
V CALL 



IFP 

IFM 

IFZ 

IFN 

ENDC 

ELSE 

FAIL 



>^ =■;«: =->: 

PZE 



Meaning 



Hexadecimal constant 

Binary (ASCII) coded 
information 

Variable field constant 

STORAGE ALLOCATION 
PSEUDO-OPERATIONS 

Block starting with symbol 

Block ending with symbol 

Block storage of zeros 

Common storage 

Set common base 

PROGRAM - LINKING 
PSEUDO -OPERATIONS 

Entry point 

Entry point 

External name 

External address constant 

Call subroutine 

CONDITIONAL ASSEMBLY 
PSEUDO-OPERATIONS 

Assemble only if plus 

Assemble only if minus 

Assemble only if zero 

Assemble only if not zero 

End of conditional assembly 

Combined IF and ENDC 

Identifies statement which 
should never be assembled 

SPECIAL SYMBOLS 

Op Code Zero 

Op Code Zero 
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In the discussion that follows, the diagram under the title of each pseudo-operation 
illustrates what the Assembler expects to find in the location, operation and operand 
fields. The comments and identification fields are used normally for all pseudo -opera- 
tions. The words "previously defined" mean "already in the symbol table even in the first 
pass. " The pseudo-operations that apply only to DAP-16 Mod 2 are footnoted. 

ASSEMBLY -CONTROLLING PSEUDO-OPERATIONS 
CFx, Computer Configuration 



LOCATION 


OPERATION 


OPERAND 


Ignored 


CFl for DDP-116 
CF3 for H316 
CF4 for DDP-416 
CF5 for DDP-516 


Ignored 



The pseudo-operation CFx defines the computer on which the program is to run and 
if used, must precede the executable instructions to be tested. If the configuration is not 
specified with CFx, the DAP-16 Mod 2 Assembler assumes that the program will be run on 
an H316 or DDP-516. The DAP-16 Assembler assumes that the source computer is the 
object type. The only effect of this pseudo -ope ration is to print O flags on the listing for 
illegal operations. The object text is unaffected. 

I^REL, Relocatable Mode 



LOCATION 


OPERATION 


OPERAND 


Ignored 


REL 


Ignored 



The pseudo-operation REL specifies the desectorizing and relocatable mode for 
assembly and loading (see Section II, Modes of Operation). The action of the REL is 
reversibly terminated by an ABS pseudo-operation and irreversibly terminated by a LOAD 
pseudo-operation. REL may not follow LOAD. 



ABS, Absolute Mode 



LOCATION 


OPERATION 


OPERAND 


Ignored 


ABS 


Ignored 



This pseudo-operation specifies the desectorizing and absolute mode for assembly 
and loading (see Section II, Modes of Operation). The assembler assumes this as the 
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operating mode in the absence of a REL, ABS, or LOAD pseudo-operation. The action 
of the ABS is reversibly terminated by a REL pseudo-operation and irreversibly termin- 
ated by a LOAD pseudo-operation. ABS may not follow LOAD. 



LOAD, Load Mode 



LOCATION 


OPERATION 


OPERAND 


Ignored 


LOAD 


Ignored 



The pseudo-operation LOAD informs the assembler that the source program from 
this point on is to be assembled in load mode (see Section II, Modes of Operation). All 
references to addresses not present in either the current sector or sector zero are 
flagged as errors on the assembly listing but do not affect the object text. Load mode 
continues in effect for the duration of the assembly. 

I/'ORG, Origin 



LOCATION 



Normal 



OPERATION 



ORG 



OPERAND 



Any previously-defined 
symbol or expression 



The assembler's location counter is given the value of the expression in the address 
field. In the desectorizing and relocatable mode, the program will be loaded at the loca- 
tion specified by the ORG plus the relocation factor, which is not normally useful. In the 
absolute mode (either desectorizing or load) the ORG specifies the exact location at which 
the program will be loaded. Any number of ORGs may be used in a program. 

Any symbol in the location field will be assigned the value of the location counter 
before the ORG is processed. 

In the following example, a relocatable program temporarily reverts to absolute and 
stores two pointers to relocatable locations. The program then returns to the relocatable 
mode giving the location counter the value it would have had if the excursion into absolute 
had not been made. 



0034 



REL 



RELOCATABLE PROGRAM 



0037 


01050 





02 00334 


LDA 


•334 


0038 


01051 





04 01573 


STA 


X47 


0039 






701 


ORG 


'334 


0040 








ABS 




0041 


00334 





004465 


DAC 


X 


0042 


00335 





00450? 


DAC 


Y 


0043 








ORG 


Z01 


0044 








RFL 




0045 


01052 


-0 


06 00335 


ADD# 


•335 


0046 


01053 





04 01574 


STA 


X48 



. . .REFERENCING SECTOR 
7ER0 

start at Location 

absolute '334, 
put in' pointers, 

AND 
RETURN TO MAIN SEOUFNCE 
(RELOCATABLE) 
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In the example below, the next instruction must be in an odd location. The DBP 
pseudo-operation (described below) forces the assembler to locate its first word in an even 
memory location. Therefore, ODD in the example below is forced to be in an odd location. 



0003 03260 

0004 Q3262 
3263 

0005 
0006 
0007 03263 



01 03263 

000000 

000000 



02 03244 ODD 



JMP 

DBP 


ODD 



ORG 
LDA 


«-l 

XNA 



DUMMY VALUE; USED FOR 

ALIGNMENT 
FORCE ODD LOCATION 
PROGRAM EXECUTION RF-SUMFS 



FIN, Assemble Literals 



LOCATION 


OPERATION 


OPERAND 


Ignored 


FIN 


Ignored 



Whenever the pseudo-operation FIN is encountered, DAP-16 starts at the present 
setting of the location counter and assembles all literals accumulated since the beginning 
of the program or since the last FIN. When the next statement is processed, the location 
counter points to the first location following the literals. The same function is performed 
by the END pseudo-operation; however, END also terminates the assembly. FIN allows 
the programmer to distribute literals throughout his program, thereby possibly reducing 
the indirect address links that the loader must supply. The program must not be allowed 
to jump to a location within the literal pool. 

MOR, Operator Action Required 



LOCATION 



Ignored 



OPERATION 



MOR 



OPERAND 



Ignored 



This pseudo -operation is used when additional material must be added to the assembly. 
When MOR is encountered the computer halts (unless the source input is on magnetic tape, 
in which case MOR is ignored). The computer resumes processing when the START button 
is pushed. MOR causes a halt on both the first and second passes. 



KEND, End Of Source Program 



LOCATION 


OPERATION 


OPERAND 


Ignored 


END 


Blank of any defined symbol or 
expression. If blank, loader 
will start execution of program 
at its first location. Otherwise, 
execution will start at address 
specified. 
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An END pseudo -operation must be the last statement in a source program; no state- 
ments are processed following an END statement. All accumulated literals are assembled 
as with a FIN statement. If this is the final pass, the value in the address field is entered 
into the object text. The loader can be directed to start execution of the program at that 
address. If the address field is blank, the first address in the program will be entered 
into the object text as the starting address. 

In a two-pass assembly from cards or paper tape, the computer halts when the END 
statement is reached on the first pass. The operator must then reposition the source text 
to its start and push the START pushbutton to initiate pass two. The second pass may be 
repeated with the same parameters or with other parameters to gain additional outputs. 

LIST -CONTROLLING PSEUDO-OPERATIONS 
EJCT, Start At Top Of Page 



LOCATION 


OPERATION 


OPERAND 


Ignored 


EJCT 


Ignored 



The pseudo-operation EJCT causes the next source line on the assembly listing to 
be printed at the top of the next page following the heading. It has no effect if the NLST 
pseudo -ope ration is in effect. The EJCT pseudo-operation is effective only when the line 
printer is being used for the assembly listing or the ASR is being used with Input/Output 
Supervisor 016-OAAA (see Section V, Input/Output Supervisors). The line containing EJCT 
i"s printed. 



LIST, Generate Assembly Listing; 
NLST, Generate No Assembly Listing 



LOCATION 


OPERATION 


OPERAND 


Ignored 


LIST or NLST 


Ignored 



The LIST pseudo-operation causes the assembly listing to be printed. The assembler 
is ordinarily in the LIST mode. NLST inhibits printing of the assembly listing. LIST and 
NLST may be used throughout a program in order to list selected sections. The line con- 
taining NLST is printed if printing is on. 
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LOADER-CONTROLLING PSEUDO-OPERATIONS 

EXD, Enter Extended Desectorizing; 
LXD, Leave Extended Desectorizing 



LOCATION 


OPERATION 


OPERAND 


Ignored 


EXD or LXD 


Ignored 



The loader forms 14-bit indirect address words (each having an indirect bit and an 
index bit) unless an EXD pseudo-operation is performed or the operator forces extended 
loading at load time. EXD causes the loader to form 15 -bit indirect address words (each 
having an indirect bit but no index bit). EXD, normally used in conjunction with the EXA 
operation, implies that the program is to be operated in EXTEND addressing mode. LXD, 
used in conjunction with the DXA operation, implies that the program is in the normal 
addressing mode. 



SETB, Set Base Sector 



LOCATION 


OPERATION 


OPERAND 


Normal 


SETB 


Normal. For one-pass 
assemblies, any symbol 
used in this field must be 
previously defined. 



The pseudo-operation SETB is used for programmer control of the location of the 
address constants. SETB causes the loader to place the address constants starting at the 
address derived from the address field of SETB. This statement may be used to ensure 
that the loader-generated address vectors are in the same sector as the instructions that 
use them. In this case, the program must reserve a block of memory locations for their 
storage. The following example shows this use of SETB. 



(1067 

0068 

0069 03000 

0070 

0071 03001 

0072 03013 



01 03013 



0? 03763 



ORG 


•3000 


SFTP 


» + l 


JMP 


• + 11 


BSS 


10 


LDA 


RT0P 



START AT BEGINNING 

OF SECTOR 3 
JUMP OVFR ADDRESS 

CONSTANTS 
UP TO 10 CONSTANTS 
CONTINUE HERE 



SETB pseudo -ope rations and loader B -register settings may be used freely to move 
the base during the course of loading a program and its subroutines. The loader allows 
only one contiguous block of base locations to be in any one sector. Thus, if the base is 
ever returned to a sector it has been directed to before (e. g. , back to sector zero) address 
constants will continue to be loaded immediately following the previous block of address 
constants loaded in that sector. For example, if the next address constant were to be 
loaded into location '134 when the loader encountered a SETB to another sector, a following 
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SETB to any location in sector zero (e. g. , SETB 0, SETB '134, or SETB '100) would re- 
turn the base to '134. 

SETB may also be used with the base-setting operation SMK '1320 (Memory Lockout 
Option). The programmer must be sure that the relocation register is properly loaded 
when the program starts executing and that storage is allocated for the address constants. 

SYMBOL -DEFINING PSEUDO-OPERATIONS 
vEQU, Give a Symbol a Permanent Value 



LOCATION 



Normal. 
Must contain 
a symbol. 



OPERATION 



EQU 



OPERAND 



Normal. Any symbol used in 
this field must be previously 
defined. 



The EQU pseudo -ope ration allows a symbol to be defined without being used in a 
location field, thereby permitting more than one symbol to refer to the same value. EQU 
also allows a symbol to be given a value outside the range of locations in the program. 
Once a symbol has been defined with EQU it may not be redefined. 

SET, Give a Symbol a Temporary Value 



LOCATION 



Normal. 
Must contain 
a symbol. 



OPERATION 



SET 



OPERAND 



Normal. Any symbol used in 
this field must be previously . 
defined. 



The SET pseudo-operation is identical to the EQU pseudo-operation, except that the 
symbol may be redefined any number of times with further SET pseudo -operations. An 
example of the use of EQU and SET pseudo-operations is shown below. At the start, EQU 
is used to set STRT = A, SI = B, and S2 = C. SET is used to set TOP = A = STRT. Later, 
TOP is reset to '4223. 



0054 
0055 
0056 
0057 

0058 01121 

0059 01122 

0060 01123 

0061 01124 

0062 01125 
0063 



001121 
001122 
001123 
001121 



STRT EQU 
Si EQU 
S2 



TOP 

* 



000000 A 
02 0116? R 
141206 C 
04 01162 
-0 01 01121 



EOU 
SET 

DAC 
LDA 
AOA 
STA 
JMP» 



# 

• ♦1 

* + 2 

* 

cm 

CNT 
TOP 



START INSTRUCTIONS 



RFTURN THROUGH 
TOP (=4) 



0067 



004223 TOP SFT -4223 



DAP-16 Mod 2 only. 
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EQU is particularly useful in making the address field of I/O instructions more read- 
able. For example, if the ASR teletypewriter is to be programmed, the following memory 
aid symbols might be chosen: 



SFT INPUT MODF 

SET 0UT p UT MOPE 

SKIP IF READY 

SKIP IF NOT BUSV 

CLEAR A AND INPUT ASCII 

OUTPUT ASCII 



000 9 


OOOOO4 


TIN EOU 


'4 


0010 


000104 


TOUT EQU 


•104 


0011 


000004 


TRDY EOU 


•4 


0012 


000104 


TNPS EOU 


•104 


0013 


001004 


TINA EOU 


•1004 


0014 


000004 


TOTA EOU 


•4 



DATA-DEFINING PSEUDO-OPERATIONS 
^DAC, Address Constant 



LOCATION 


OPERATION 


OPERAND 


Normal 


DAC or DAC* 


Normal. Indexing may 
be specified. 



The low-order 14 bits of address generated from the address field of a DAC pseudo- 
operation is combined with the indirect bit (if specified by an asterisk after DAC) and index 
bit (if specified by , 1 after the address). Relocatable addresses are relocated during 
loading. If extended desectorizing has been specified with EXD, the loader will form 15- 
bit instead of 14-bit addresses (without regard to the index bit). Thus, the programmer 
must be careful in using address constants with the index bit set. A 14-bit number with 
indirect and index bits, or a 15-bit number with indirect bits, is generated by the loader 
for any positive expression or negative relocatable expression. A 16 -bit negative number 
is generated for negative absolute expressions. 

There is no provision for literal address constants. Thus, a DAC must be used and 
given a symbolic value for each indirect reference. For example, to transfer the address 
of location FIND to location PUT, the following statement must be written: 



0110 03617 

0111 03620 



02 03045 
04 03300 



LDA 
STA 



ADDP 
pi I T 



0115 03045 



003307 ADDR DAC 



FIND 



The following example shows address constants used in several ways. This sequence 
works properly only for programs operating in the normal addressing mode, because the 
desired post indexing is specified in the address constants. The example moves 10 words 
from a buffer specified by the calling sequence to a buffer in the example program. 
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0003 
0004 

0005 03355 

0006 03356 
0007 

0008 03357 

0009 03360 



10 05375 
003372 



01 03374 



SAMPLE CALLING SEOUFNCE FOR TRANSFER SUBROUTINE 
(NORMAL ADDRESSING) 



JST 
DAC 

JMP 
BUF1 BSS 



TRNS 
BUF1*10,1 

CONT 
10 



CALL TRANSFER SUBROUTINE 
INDEXED POINTER 

TO FIRST BUFFER 
CONTINUE AT CONT 
FIRST BUFFER 



0013 

0014 05375 

0015 

016 

0017 05376 

0018 05377 
0019 

0020 05400 

0021 

0022 

0023 05401 

0024 

0025 05402 

0026 05403 

0027 05404 

0028 05405 
0029 

0030 05406 

0031 05407 
0032 

0033 05410 

0034 05411 

0035 05423 



TRANSFER SUBROUTINE 



-0 000000 



TRNS DAC* ** 



35 0542-" LOX =-10 
■0 02 05375 LOOP LDA» TRNS 



-0 04 05410 

12 00000 

01 05377 
02 05375 
140100 
141206 

04 05423 
-0 01 05423 

1 005423 
000000 



STA« AC1 



IRS 

JMP 
LOA 
SSP 
AOA 



AC1 DAC 
BUF2 BSS 
TEMP 8SZ 



LOOP 
TRNS 



STA TFMP 
JMP* TFMP 



BHF2+10.1 

10 

1 



TRANSFER SUBROUTINE 
ENTRY POINT. HAS 
INDIRECT FLAG SET. 
TEN TRANSFERS WILL BE MADE 
PICK UP WORD USING IN- 
DIRECT AND INDEXED DAC 
STORE IN RUFFER, USING 
ANOTHFR INDIRECT, 
INDEXED DAC 
UPDATE INDEX USED FOR 

BOTH RUFFERS 
CONTINUE IF NOT DONE 
PICK UP RETURN POINTER 
REMOVE INDIRECT FLAG 
INCREMENT TO POINT TO 

RETURN POtNT 
STORE IT 
RETURN TO RETURN POINT 

INDEXFD POINTER 

SECOND BUFFER 

TFMPORARY POINTER LOCATION 



The following example shows this same subroutine rewritten for operation in extended 
addressing. Notice that indexing must now be specified in the instruction rather than the 
address constant. 



0040 



0041 








» 


(FXTENDFD ADDRESSING) 


0042 


03355 





10 05375 




JST 


TRNS 


0043 


03356 





003372 




DAC 


BUF1»10 


0044 


03357 





01 03374 




JMP 


CONT 


0045 


03360 






RUF1 


BSS 


10 


0049 








• 


TRANSFER SUBROUTINE 


0050 


05375 


-0 


000000 


TRNS 


DAC» 


• • 


0051 








* 






0052 








* 






0053 


05376 





35 05424 




LDX 


= -10 


0054 


05377 


-1 


02 05375 


LOOP 


LDA» 


TRNSJ1 


0055 








* 






0056 








* 






0057 


05400 


-1 


04 05410 




STA« 


ACl.l 


0058 








# 






0059 








* 






0060 


05401 





12 00000 




IRS 





0061 








* 






0062 


05402 





01 05377 




JMP 


LOOP 


0063 


05403 





02 05375 




LDA 


TRNS 


0064 


05404 


140100 




SSP 




0065 


05405 


141206 




AOA 




0066 








• 






0067 


05406 





04 05423 




STA 


TEMP 


0068 


05407 


-0 


01 05423 




JMP» 


TEMP 


0069 








« 






0070 


05410 





005423 


AC1 


DAC 


BUF2+10 


0071 


05411 






RUF2 


BSS 


in 


0072 


05423 


onoooo 


TEMP 


BSZ 


1 



SAMPLE CALLING SEQUENCE FOR TRANSFER SUBROUTINE 



CALL TRANSFER SUBROUTINE 
POINTER TO FIRST BUFFER 
CONTINUE AT CONT 
FIRST BUFFER 



TRANSFER SUBROUTINE 
ENTRY POINT. HAS 
INDIRECT FLAG SET. 
TEN TRANSFERS WJLl BE MADE 
PICK UP WORD USING IN- 
DIRECT DAC KITH 
POSTHNDEX 
STORE IN BUFFER. USING 
ANOTHFR INDIRECT 
DAC WITH POST-INDEX 
UPDATE INDEX USED FOR 

BOTH BUFFERS 
CONTINUE IF NOT DONE 
PICK UP RETURN POINTER 
REMOVE INDIRECT FLAG 
INCREMENT TO POINT TO 

RETURN POINT 
STORE IT 
RETURN TO RETURN POINT 

POINTER 

SECOND BUFFER 

TEMPORARY POINTER LOCATION 
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Address constants may also be used to define ranges by subtraction. In this case, 
the only restriction is that the result must be a positive number less than 16, 384 (or 
32, 768 if the program is being loaded with extended addressing). In the following example, 
the assembler calculates the length of the buffer and enters it as the first word. 



5 4 



000100 



lH (i T FOU 



100 



0057 01341 0001.00 PU FF DAC I. A ST-8U FF + 1 

0058 01342 000000 BSZ LNQT-? 

0059 01440 000000 LAST BSZ 1 



(The BSZ pseudo-operation is described in this section. ) Notice that the length of the buffer 
has been specified to the assembler by LNGT earlier (using EQU or SET). 



Ir^DEC, Decimal Constant; 

DBP, Double Precision Constant 



LOCATION 


OPERATION 


OPERAND 


Normal 


DEC or DBP 


One or more subfields, each 
containing a decimal data item. 
As many subfields can be used 
as can fit in columns 12-72, but 
no more than 2 9 words can be 
generated. 



These pseudo-operations, DEC and DBP, cause DAP-16 to convert each subfield to 
one, two, or three words of binary data with the desired value in either fixed-point or 
floating-point format. As each subfield is encountered, the next successive memory 
location is used. Subfields are separated by commas. 

The addition and subtraction operations may be used in DEC and DBP address sub- 
fields, for example: 



0119 00633 



002010 



DEC 



1024*8 



The DBP pseudo-operation is identical to the DEC pseudo-operation, except that in 
all cases two words are generated and the first word is always in an even memory location. 
This allows constants generated by DBP to be loaded and stored using DLD and DST of the 
High-Speed Arithmetic Option. The loader maintains the double-word boundary alignment. 

Figure 3-1 shows the general format of numerical values for DEC and DBP. Table 
3-2 summarizes subfield conversions for DEC or DBP. Further details on writing sub- 
fields for either DEC or DBP follow Table 3-2. 
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(+) n. . . n [. n. . . n] [^ <+) mm] [^ (±) PP ] 



mantissa 


characteristic 


scale 


or 


or 


factor 


fraction 


exponent 





Figure 3-1. General Format for Numerical Values 



TABLE 3-2 SUBFIELD CONVERSIONS FOR DEC AND DBF PSEUDO- OPERATIONS 


Condition 


DEC 
Pseudo-Op 


DBP 
Pseudo-Op 


V i. 


No decimal point, B, or E (B15 

assumed) 

or 
B (with or without decimal point, 

E, or EE) 


Fixed, 1 word 


Fixed, 2 words 


2. 


BB (with or without decimal point, 
E, or EE) 


Fixed, 2 words 


Fixed, 2 words 


3. 


Decimal point, no B or E 

or 
E, no B (with or without decimal 
point) 


Floating, 2 words 


Floating 2 words 


4. 


EE, no B (with or without decimal 

point) 


Floating, 3 words 


2 
Floating, 2 words 



The second word is always '000000. 

2 
No third word is generated when EE is used with DBP. 

Use of Plus and Minus Signs. -- A plus or minus sign (unary operator) may be used before 
any number in a DEC or DBP subfield (including the numbers which follow B or E). The 
plus sign is always optional. 

Use of B (Binary Point Position). -- The letter B followed by a number is used to specify 
the location of the binary point in evaluating fixed-point data. The number following the B 
is the number of positions the binary point is shifted from the standard assumed location 
between bits 1 and 2. For example, 3B5 means assemble a word with the value of 3 if the 
binary point is considered to be 5 bits to the right of the standard position (i. e. , between 
bits 6 and 7, see Figure 3-2). 

The hardware binary point location between bits 1 and 2 is important only for multipli- 
cation and division. The Assembler therefore assumes a binary point following bit 16 (B15) 
when the B is not specified. 
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FIRST WORD 



1 


2 


3 


4 


5 


6 


7 


8 


9 10 


11 


12 13 


14 15 


16 


I I I I I I I I I I I I I I I 



f t t t t t t t t t t t t t t t t 

B-1 BO B1 B2 B3 B4 B5 B6 B7 B8 B9 B10 B11 B12 B13 B14 B15 



L 



THE COMPUTER TREATS ALL NUMBERS 
AS IF THE BINARY POINT WERE HERE 



THE ASSEMBLER CONSIDERS ALL 
UNSPECIFIED BINARY POINTS TO 
BE HERE 



SECOND WORD 



°l I I I I I I I I I I I I I 



t t t t t t ♦ ♦ t t t t t t t t 

B15B16B17B18B19B20B21B22B23B24B25B26B27B28B29B30 



Figure 3-2. Binary Point Position 

Use of E (Decimal Point Position). -- The letter E followed by a number is used to specify 
the position of the decimal point in either fixed-point or floating-point data. The E should 
be read as "times ten to the. . . ". For example 3E5 means assemble a floating point word 
with the value of 3 x lO* 1 (300, 000). The number following the E is known as the exponent 
or characteristic, and the value before the E is known as the fraction or mantissa. 

Use of the Decimal Point. -- A decimal point may be specified in any floating-point number 
and some fixed-point numbers. However, it may not be used in the number specifying the 
exponent or the position of the binary point (that is, following E or B). 

V^Fixed-Point Word Formats. -- Figure 3-3 shows the word format for single and double- 
precision fixed-point words. The central processor always treats fixed-point words as if 
the binary point were between bits 1 and 2. Negative numbers are in twos -complement 
form. All bits of a double-precision word except bit 1 of the second word are twos comple- 
mented. Bit 1 of the second -word is always 0. 

Specifying Fixed-Point Data. -- Fixed-point data is specified either by no modifier at all 
(e. g. , 349) or by a B or BB with or without an E or a decimal point (e. g. , 349. 3B13). 
B signifies single precision, and BB signifies double precision. 
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SINGLE -PRECISION 



FIXED -POINT FORMAT: 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 



V 



I I I I 



J L_l L_l l__L 



INTERNAL POSITION OF THE BINARY POINT 
SIGN BIT 



DOUBLE -PRECISION 



FIRST WORD 



FIXED -POINT FORMAT: 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 



I I I I I I I I 



I I I I 




15 MOST SIGNIFICANT BITS 
POSITION OF THE BINARY POINT 

SIGN BIT 



SECOND WORD 



t 



J I I I I 1 I I I II 



15 LEAST SIGNI FICANT BITS 
ALWAYS ZERO 



(Negative numbers are represented by two's complement of absolute 
value. Bit of second word in double-precision is always for both 
positive and negative numbers. 

Figure 3-3. Fixed-Point Word Formats 

The effect of B and BB is to move the actual point to an assumed position. B or BB 
is referred to as a scale factor since it allows the programmer to scale his number to a 
value more easily handled. The relationship is: 

Nj = N (2" P ) 
where N. is the value o± the generated word, with the binary point between bits 1 and 2; 
N_ is the original value of the number in the DEC, DBP, or literal address field; and P is 
the value following B or BB. Any low-order bits beyond 15 (or 30) bits of significance are 
truncated without rounding. 

E may also be used in fixed-point numbers if B is present. The formula above is then 
modified to: 

Nj = N (2- P )(10 X ) 
where 1NL, N_, and P have their former significance and X is the value following E. The 
DAP-16 Assembler flags an error for any value of N. not between -1 and +1. 

The following example delineates fixed-point conversions and serves to point out 
errors. The last four conversions show that there is no rounding in the conversion. The 
binary approximation to 1/10 (which often appears in conversions) is also shown. 
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VC 



0023 00346 

0024 00347 

0025 00350 
00351 

0026 

0027 00352 

0028 00353 
0029 

0030 00354 

0031 00355 

0032 00356 

0033 00357 
00360 

0034 00362 
00363 

0035 00364 
00365 

0036 00366 
00367 

0037 00370 
00371 

0038 00372 
0039 

0040 00373 

0041 00374 
0042 

0043 

0044 00375 

0045 00376 
00377 

0046 00400 

0047 00401 
00402 



000017 
177761 

041170 
000000 

177610 
000170 

074000 
000170 
001700 
000000 
017000 
000000 
001700 
000000 
001700 
074000 
000000 
000001 
070000 
000000 

020000 
001717 



000001 
000001 
006314 
000001 
000001 
077777 



DEC 
DFC 
DFC 


15 
-15 

150F-1 


DEC 

DFC 


-15B+12 
15B12 


DEC 
DEC 
DEC 
DEC 


1581 

150E-1B*12 
+0.15E2R9 
1.5E+13R21 


DBP 


1.5E1BB24 


DBP 


15000E-3BB24 


DBP 


15BB+1 


DBP 


+15BB18 


DEC 


'17P15 


DEC 
DEC 


0.125B-1 
15+.0015E4B9 



DECIMAL 15 = OCTAL 17 
NEGATIVF OF FIRST EXAMPLE 
EPROR--RESULT IS FLOATING 

POINT (NO 8) 
SFCOND EXAMPLF TIMES 8 
NFGAT1VF OF PPEVIOUS 

EXAMPLE 
ERROR-- TOO LARGE 
USE OF ROTH E AND 8 
PREVIOUS EXAMPLE TIMES 8 
DOUBLE PRFCISION USING DEC 

DOUBLE PRECISION USING OBP 

SAM F AS PREVIOUS EXAMPL F 

ERROR--TOO LARGE 

BIT 17 ALWAYS = 

ERROR--CANNOT USE B 

OR 6 WITH APOSTROPHE 
USE OF NEGATIVE 8 
USE OF ADDITION 



THE FOLLOWING CONVERSIONS SHOW 
TRUNCATION AND THF RINARY VALUE OF 1/10 
DEC 1,1815 
DEC 1.1BB15 



DEC 

DEC 



1,99999815 
1.99999BB15 



Floating-Point Word Formats. --Figure 3-4 presents the format for single- and double- 
precision floating-point words. Negative numbers are constructed by assembling a posi- 
tive number and taking the twos complement of the entire two- or three-word number 
including the exponent. 

The exponent is a power-of-two expressed in excess-128 notation. This gives a range 
127 4-177 ^8 4-^8 

between 2 and 2 (about 10 to 10 ). The number zero is represented by using 

a number of all zero digits. 

Specifying Floating-Point Data. -- Floating-point data is specified by an E without a B, an 
EE without a B, or a decimal point without a B. One E specifies single-precision (two 
words); two Es specify double -precision (three words). 

The DAP-16 Assembler automatically generates the floating-point number with the 
largest possible (normalized) fraction (< 1). An error is flagged if an exponent with an 
absolute value greater than 12 7 is required. Zero is converted to two or three words of 
all zeros, and excess bits are truncated. 
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SINGLE -PRECISION 



FIRST WORD: 



SECOND WORD: 



DOUBLE -PRECISION 



FIRST WORD: 



SECOND WORD: 



FLOATING - POINT FORMAT: 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 



J I I I I I I I I I I 



EXPONENT 
(EXCESS - 128 NOTATION) 
-SIGN BIT 



_L 



MOST SIGNIFICANT 

7 BITS OF THE FRACTION 

- POSITION OF THE BINARY POINT 



J L 



J I I I I I I I 



LEAST SIGNIFICANT 16 BITS OF THE FRACTION 



FLOATING-POINT FORMAT: 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 



■ I ■ ■ 



■ ■ ■ I 



J L 



EXPONENT 
(EXCESS -128 NOTATION) 
-SIGN BIT 



MOST SIGNIFICANT 

7 BITS OF THE FRACTION 

_ POSITION OF THE BINARY POINT 



J 1 1 I I I I I ■ I ' ■ I 



J l_ 



NEXT MOST SIGNIFICANT 16 BITS OF THE FRACTION 



THIRD WORD: 



J I I I L 



I I I I I I 



LEAST SIGNIFICANT 16 BITS OF THE FRACTION 



VALUE OF NUMBER IS FRACTION X 2 RAISED TO EXPONENT. 
NEGATIVE NUMBERS ARE REPRESENTED BY TWO'S COMPLEMENT 
OF ENTIRE POSITIVE NUMBER INCLUDING EXPONENT. 



Figure 3-4. Floating-Point Word Formats 
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The following example illustrates floating-point decimal conversions and serves to 
point out errors: 



0003 
0004 
0005 
0006 

0007 
0008 

0009 
0010 

0011 
0012 

0013 
0014 

0015 
0016 



0017 
0018 



00223 
00224 

00225 
00226 

00227 
00230 

00231 
00232 

00233 
00234 

00235 
00236 
00237 



040100 
000000 

037777 
177777 

137700 
000000 

042700 
000000 

037500 
000000 

040544 
103755 
050420 



« FLOATING POINT EXAMPLES 

» EXPONENT FRACTION 

» NO. 1 1/2 TIMES 2 TO THF 

DEC 0.5 200 



.400. . . 
.777... 



00240 040000 



• NO. 2 SLIGHTLY LESS THAN NO. 1 
DEC 0.49999999 177 

» NO. 3 2S COMPLEMENT OF NO. 1 
DEC -0.5 

» NO. 4 NO. 1 T1MFS 2 TO THE 11 

DEC 1.024E3 213 .400... 

» NO. 5 NO. 1 TlMFS 2 TO ThF -2 

DEC 125F-3 176 .400... 

« NO. 6 Pi (IN noUBl E PRECISION) 

DEC 3.l4l5926535898EEn 202 .62207* 



» NO. 7 ERROR — FIXED POINT. NOT FLOATING POINT 
DEC 16E0B5 (P IS PRESENT) 



^OCT, Octal Constant; 
HEX, Hexadecimal Constant 



LOCATION 


OPERATION 


OPERAND 


Normal 


OCT or HEX 


One or more subfields, each 
containing an octal or hexa- 
decimal data item. As many 
subfields can be used as can 
fit in columns 12-72, but no 
more than 2 9 words can be 
generated. 



These pseudo-operations, OCT or HEX, cause DAP-16 to convert each subfield to 
one word of binary data with the desired value. As each subfield is encountered the next 
successive memory location is used. Subfields are separated by commas. 

Octal numbers use the' characters through 7, plus, minus, and apostrophe. The 
apostrophe is redundant but acceptable. Hexadecimal numbers use the character through 
9, A through F, plus, minus, and dollar sign. A through F represent decimal numbers 
10 through 15 and are contiguous to through 9. The dollar sign is redundant but accept- 
able. Hexadecimal and octal data may not be mixed in these pseudo-operations. 



DAP-16 Mod 2 only 
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The binary point is fixed following bit 16 with both OCT and HEX. However, there is 
no provision for moving the point with B or E as there is with DEC and DBP. The following 
example illustrates binary conversions using OCT and HEX: 





0018 


01021 


000015 


OCT 


15 




0019 


01022 


000015 


OCT 


♦ 15 




0020 


01023 


177763 


OCT 


-15 


cvc 


0021 
0022 


01024 


000000 


OCT 

• 


15B? 




0023 


01025 


177763 


OCT 


177763 


c 


0024 


01026 


onoooo 


OCT 


200000 




0025 


01027 


000025 


HFX 


15 




0026 


01030 


177753 


HFX 


-15 




0027 






« 






0028 


01031 


177777 


HEX 


FFFF 


c 


0029 


01032 


073543 


HEX 


177763 



DECIMAL 13 

SAME AS FIRST EXAMPLE 
NEGATIVF OF FIRST EXAMPLE 
ERR0R--R AND F CANNOT 

BE USFD IN OCT AND HEX 
SAMF AS THIRD EXAMPLE 
ERR0R--T00 LARGE 
DFCIMAL 21 
NFGATIVF OF PREVIOUS 

EXAMPLE 
-1 
ERR0R--T00 LARGE 



•BCI, Binary (ASCII) Coded Information 



LOCATION 



Normal 



OPERATION 



BCI 



OPERAND 



A decimal number, N, followed 
by a comma and 2N alpha- 
numeric characters. N speci- 
fies number of words to be 
formed and cannot exceed 29. 



The BCI pseudo-operation causes DAP- 16 to convert each group of two characters to 
a binary word in USASCII code. A symbol in the location field is assigned to the location 
of the first word. The words generated are stored in successively higher storage locations 
as the address field is scanned from the left. The first character of a pair is stored in the 
most significant bits. Blanks are acceptable characters and do not terminate the address 
field. The comments field follows the 2Nth character. 

The following example shows a conversion of eight words to USASCII. Note that the 
last two and one-half words contain USASCII blanks ('240). The symbol FINI is assigned to 
the first word. 



0056 00027 
00030 
00031 
00032 
00033 
00034 
00035 
00036 



151305 
146317 
140704 
120324 
140720 
142640 
120240 
120240 



FINI BCI 



8, RELOAD TAPE 



VFD, Variable Field Constant 



DAP- 16 Mod 2 only. 



LOCATION 


OPERATION 


OPERAND 


Normal 


VFD 


Up to 16 pairs of subfields. 
Each subfield must contain 
a symbol or expression 
composed of symbols defined 
in object program. 
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The VFD pseudo-operation allows a 16-bit word to be formed, with the programmer 
having complete control over each bit. The first subfield of a pair specifies the number of 
bits to be controlled by the next subfield (starting with the most significant end of the word). 
The second subfield of a pair provides the value to be inserted. This value will be truncated 
to the number of bits given in the first subfield with no error indication. Each pair of sub- 
fields defines one or more bits from the most- significant to the least- significant bits of 
the word. Unspecified bits at the least- significant portion of the word are filled with zeros. 
An error indication is given if more than 16 bits are specified. The following examples 
show data conversions using VFD: 



0003 
0004 
0005 
0006 
0007 
0008 
0009 
0010 

non 

0012 



01277 
01300 

01301 



01302 
01303 

01304 



177777 
10661? 

00641? 



040000 
006060 

100063 



VFD 
VFD 

VFD 



VFD 
VFD 

VFD 



16, '177777 
8, '215, P, '212 



■1 



CARRIAGE RETURN, 
LINE FEED 
1,0,7, '215,1,0,7, '212 

same, with msb = 
For each character 

2.1 BIT 2 ONLY 

6,3,6,3,6,3 E rror--18 BITS 

SPECIFIFD 
1,1,15, '63 SAME AS DAC* *63 



STORAGE ALLOCATION PSEUDO-OPERATIONS 

BSS, Block Starting With Symbol; 
BES, Block Ending With Symbol 



LOCATION 


OPERATION 


OPERAND 


Normal 


BSS or BES 


Normal. Only one subfield 
allowed. Any symbol used 
must be previously defined. 



These two pseudo- operations, BSS and BES, effectively reserve a block of storage 
without defining its contents by advancing the location counter. The value in the address 
field specifies the size of the block in words. If there is a symbolic name in the location 
field, BSS causes that symbolic name to be assigned to the first location in the block, 
while BES causes it to be assigned to the first location following the block. In the following 
two examples a block of storage is defined from '1000 to '1027 inclusive. The symbol BUF 
is assigned the value '1000 by BSS and '1030 by BES. 



0073 

0074 01000 

0075 01030 



BUF 



001000 



ORG 
BSS 
DAC 



•1000 

•30 

BUF 



0071 

0072 01030 

0073 01030 



001030 



BUF 



ORG 
BES 
DAC 



'1000 

•30 

BUF 
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yfeSZ, Block Storage of Zeros 



LOCATION 


OPERATION 


OPERAND 


Normal 


BSZ 


Normal. Only one subfield 
allowed. Any symbol used must 
have been previously defined. 



The pseudo-operation BSZ reserves a storage block which is initialized to zeros when 
the object program is loaded. The first zero location is shown on a DAP-16 Mod 2 Assembly 
Listing. All zero locations are shown on a DAP-16 Assembly Listing. 

COMN, Common Storage 



LOCATION 



Normal 



OPERATION 



COMN 



OPERAND 



Normal. Only one subfield 
allowed. Any symbol used 
must be previously defined. 



The loader establishes a pool of common values in upper memory using the pseudo- 
operation COMN. The top of this pool is initialized by the loader but may be moved using 
SETC (DAP-16 Mod 2 only). The block resulting from each COMN encountered in a program 
is placed lower in memory than the previous one. (See COMMON Storage below for 
discussion of DAP-16 and FORTRAN COMMON. ) 



SETC, Set Common Base' 



LOCATION 


OPERATION 


OPERAND 


Ignored 


SETC 


Normal. Only one subfield 
allowed. Any symbol used 
must be previously defined. 



The loader initializes the COMMON base (the highest location in common) to a loca- 
tion near the top of memory (or the present memory bank in systems with over 16K 
locations). The SETC pseudo- operation allows another location to be specified. All pro- 
grams referencing this block of COMMON must use the same value in the address field 
of SETC. 

COMMON Storage 

DAP-16 Convention. -- The absolute address assignments are made at the time of assem- 
bly. The assembler maintains an internal COMMON base, which is initially set to 'XX600 
(where XX is the last sector of memory). It may be reset at any time by the DAP-16 Mod 2 
Assembler by the SETC pseudo-operation. When a symbol is defined by a COMN pseudo- 
operation, the number of locations specified in the address field is subtracted from the 
current COMMON base. The result is both the address assigned to the symbol and the new 
COMMON base. Figure 3-5 presents an example of this procedure. 



DAP-16 Mod 2 
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DAP- 16 Coding 



* STATEMENT 



* 






c 
I 

A 


COMN 
COMN 
COMN 


2 
1 
2 



RESULTING 

BASE 



SYMBOL 
ASSIGNED 



'27600 (ORIGINAL VALUE) 

•27576 C = '27576 

•27575 I = '27575 

•27573 A = '27573 



Storage Allocation Diagram: 

'27600 
'27577 
'27576 
'27575 
'27574 
'27573 





C+l 


c 


I 


A+l 


A 



Figure 3-5. COMMON Allocation in DAP- 16 

In the following examples, two programs reference the same COMMON location at 
the top of sector 6 (location '6776). The first program refers to this location as LBUF, the 
second as PASS: 



0066 
0067 
0068 00567 



006776 
006776 



SETC '6777 
LBUF COMN 1 
LDAC DAC L«UF 



SFT COMMON BASE 

ONE VALUE NAMED LBUF 

POINTER TO LBUF 



0072 00634 

0073 00635 



02 00344 
-0 04 00567 



LOA 
STA» 



= 1 
LDAC 



STORE 1 
IN LBUF 



0079 
0080 
OOfil 05501 



006776 
006776 



SFTC 
PASS COMN 
PDAC DAC 



•6777 

1 

PASS 



SAME COMMON BASE 
NOW CALLED PASS 
POINTFR TO PASS 



0085 05525 

0086 

0087 



-0 0? 05501 



LDA» PDAC 
» (=1 IF PRFVIOUS 
» TO ACCESS THIS 



PICK UP VALUE 
PROGRAM WAS THE LAST 
.OCATION) 



IN PASS 
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FORTRAN Convention. -- The FORTRAN compiler passes a 'displacement rather than an 
absolute address to the loader for each variable in COMMON. The loader determines the 
address by subtracting the displacement from the COMMON base. This base may be al- 
tered when the program is loaded. The displacements assigned by FORTRAN are such that 
the first variable mentioned has the largest displacement (and is lowest in memory) and 
the last variable mentioned has the smallest displacement (and is highest in memory). The 
address assignment may be altered at run time by changing the loader's COMMON base 
(relative location '2000 in LDR-APM). If the two COMMON statements below are the last 
COMMON statements in a FORTRAN program, and if the loader COMMON base is set to 
'27600, these statements will reference the same locations shown in Figure 3-5. a 

COMMON A, I 

COMMON C 

Note that variables in COMMON must be named in the opposite order in DAP- 16 and 
FORTRAN. 

PROGRAM- LINKING PSEUDO-OPERATIONS 

■L 

ENT, Entry Point; 
/SUBR, Entry Point 



LOCATION 



Ignored 



OPERATION 



ENT or SUBR 



OPERAND 



One or two subfields contain- 
ing a name of one to six 
characters. 



ENT and SUBR are two names for the same pseudo-operation. This pseudo-operation 
usually precedes executable instructions; however, it maybe used anywhere. These pseudo- 
operations cause the assembler to output the symbolic name from the address field in the 
object text. Its value at load time can then be saved by the loader for use by other programs 
(via EXT, XAC, or CALL). The loader starts loading a CALLed subroutine from the point 
where the programmer placed the ENT or SUBR. Thus, it is possible to bypass the begin- 
ning of a subroutine. If there are two names in the address field these names are considered 
synonyms within the assembler. DAP- 16 looks for the value of the second name in the 
symbol table and assigns that value to the first name for use by other programs. Although 
only four characters are used for names within a program, up to six characters may be 
communicated between programs. The extra one or two characters are ignored when 
searching the symbol table for a value. 

The following is an example routine with three entry points. Other programs may 
call the first entry using either SINE or SINF. The second entry may only be called COSINE. 
The third entry may only be called ARCTAN. This entry point has been placed following the 
SINE and COSINE entry points, because the ARCTAN routine uses none of the instructions 
above its entry point. 



A and C are FORTRAN Real Variables occupying two words; I is an Integer Variable occu- 
pying only one word. 

ENT is supported only in DAP- 16 Mod 2. 
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0077 




SUBR 


SINE 


0078 




ENT 


SINF.SINE 


0079 




* 




0000 




ENT 


COSINE 


0081 00543 


000000 


SINE DAC 


• « 



NAME FOR SINE ROUTINE 
ALTERNATE NAME FOR 

SINE ROUTINF 
NAME FOR COSINE ROUTINE 
START OF SINE ROUTINE 



00fl5 00630 -0 01 00543 JMP« SINE 
0086 00631 000000 COPI DAC •« 



EXIT FROM SINF ROUTINE 
START OF COSINE ROUTINE 



0090 00662 -0 01 00631 JMP« COSI 

0091 SUBR ARCTAN.ATAN 

0092 00663 000000 ATAN DAC *» 



EXIT FROM COSINF ROUTINF 
NAME FOR ARCTAN ROUTINE 
START OF ARCTAN ROUTINE 



0096 00705 -0 01 00663 



JMP» ATAN 



EXIT FROM ARCTAN ROUTINF 



EXT, External Name 



LOCATION 


OPERATION 


OPERAND 


Ignored 


EXT 


A name of one to six characters. 



The EXT pseudo-operation signals the loader that the name in the address field is 
not defined in this program. An error is flagged if executable instructions preceed EXT, 
but this error may have no effect on the object text. If the name is referenced later in the 
program the loader will make the proper linkage. Loading will not be complete until a 
subroutine using the name in an ENT or SUBR pseudo-operation has been loaded. In the 
example below, the loader is informed that a program defining SRTE as an accessible 
location via ENT or SUBR must be linked to this one: 



0002 



EXT SRTF 



0006 00070 02 00000 



LDA SRTE 



l/XAC, External Address Constant 



LOCATION 


OPERATION 


OPERAND 


Normal 


XAC or XAC* 


Any external subroutine name. 
Indexing may be specified. 



The XAC pseudo- operation is the same as the DAC pseudo-operation, except that the 
loader fills the low-order 14 bits (15 if extended desectorizing has been specified) with 
the address of an external name specified by another program. 

EXT allows the programmer to treat an external name as if it were part of the current 
program. XAC performs the same function but, in addition, allows the programmer to con- 
trol the location of the indirect link. 



DAP- 16 Mod 2 only. 
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•CALL, Call Subroutine 



LOCATION 


OPERATION 


OPERAND 


Normal 


CALL 


Any external subroutine name. 



The CALL pseudo-operation simultaneously specifies a JST operation and EXT 
pseudo-operation (which is effective, however, only for the processing of that one state- 
ment), 

The following examples link two programs, A JST is inserted in location ARC 
linking (indirectly if necessary) to the entry point ARCTAN of another subroutine. In the 
second example, the name ARCTAN is valid throughout the program, but in the remaining 
examples it is valid only in the statement shown. 



0091 01672 



10 00000 ARC CALL ARCTAN 



0002 EXT ARCTAN 

0006 0167? 10 00000 ARC JST ARCTAN 

0083 01672 -0 10 01715 ARC JST* ARCT 



0087 01715 



000000 



ARCT XAC 



ARCTAN 



CONDITIONAL ASSEMBLY PSEUDO-OPERATIONS' 

IFP, Assemble Only if Plus; 

IFM, Assemble Only if Minus; 

IFZ, Assemble Only if Zero; 

IFN, Assemble Only if Not Zero 



LOCATION 


OPERATION 


OPERAND 


Ignored 


IFP, IFM, IFZ, or IFN 


Normal. Only one subfield 
allowed. Any symbol used 
must be previously defined. 



The address field is evaluated at assembly time. If the condition specified by the 
operation field is not met, assembly is inhibited until an ELSE or ENDC is encountered. 
Otherwise, assembly continues uninterrupted. In the following example assembly would 
always be inhibited: 

0092 IFZ 1 

Assembly would be inhibited in the following example if symbolic name NAM2 has a smaller 
value than symbolic name NAM1. 

0097 IFM NAM1-NAM2 

See Using Conditional Assembly on the following page for further details. 



Conditional assembly is supported only in DAP- 16 Mod 2. 
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ENDC, End of Conditional Assembly 



LOCATION 


OPERATION 


OPERAND 


Ignored 


ENDC 


Ignored 



The ENDC pseudo-operation removes the effect of a preceeding IF statement with 
which it is paired. When conditions are nested this fact may not restore inhibited assembly. 
A Z-error is flagged if the END statement is reached before all IFs have been matched by 
ENDCs. 



ELSE, Combined IF and ENDC 



LOCATION 


OPERATION 


OPERAND 


Ignored 


ELSE 


Ignored 



The ELSE pseudo- operation is used as a switch between inhibited and uninhibited 
assembly and has the following effects. 

a. Between any IF and an ENDC when assembly is not inhibited, ELSE acts as 



0111 
0112 



ENDC 
IFN 



That is, it matches the previous IF statement and generates a new statement 
that inhibits assembly. 
b. Between any IF and an ENDC when assembly is inhibited, ELSE acts as ■ 



0096 
0097 



ENDC 
IFZ 



c. 



That is, it removes the inhibition unless this IF/ENDC pair is nested within 

another statement that is causing the inhibition, 

A Z-error is flagged if ELSE is used anywhere other than between an IF and an 

ENDC. 



FAIL, Identifies Statement Which Should Never Be Assembled 



LOCATION 


OPERATION 


OPERAND 


Ignored 


FAIL 


Ignored 



The FAIL pseudo-operation causes an O-error and is used in conditional assemblies 
to ensure that the conditions are logically consistent. 

Using Conditional Assembly 

Conditional assembly allows a comprehensive source program to be written covering 
many conditions. Parameters are passed using SET or EQU pseudo- operations at the be- 
ginning of the program to effect different assemblies for different objects. These state- 
ments can control the variables used by Conditional Assembly statements and consequently 
cause assembly of only those parts of the program necessary to this objective. 
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The following four examples show the same program assembled in four ways. Four 
parameters, VI, V2, V3, and V4 control the assembly. Note that nothing is assembled if 
VI = V2. If VI if greater than V2, only the FAIL pseudo-operation is assembled, otherwise 
some combination of instructions is assembled. 

In the routine below VI = 1, V2 = 3, V3 = 1, and V4 = 0. First is a listing showing 
both assembled and skipped lines listed (see Performing an Assembly). 



0112 

0113 

0114 

0115 

0116 

0117 

0118 

0119 

0120 

0121 00337 

0122 

0123 00340 

0124 00341 
0125 

0126 

0127 

0128 

0129 

0130 

0131 

0132 

0133 

0134 

0135 

0136 

0137 

0138 

0139 00342 

0140 

0141 00343 

0142 

0143 



000001 
000003 
000001 
000000 



10 00375 

10 00452 
04 00665 



100400 

01 00301 



* 




EXAMPLE OF CONDITIONAL ASSEMBLY 


VI EOU 


1 


V2 eou 


3 


V3 eou 


1 


V4 EOU 





IFN 


V1-V2 




IFP 


V1-V2 




FAIL 






= ELSF 






JST 


A3X 




( — IFZ 


V1-V3+V4 




JST 


B3x 




STA 


TEMP 




= ELSE 






JST 


C3X 






r IFM 


V2-V4 






JST 


D3X 






ADD 


TEMP 






STA 


TFMP 






r ELSF 








LDA 


= -1 






ADD 


TFMP 






STA 


TFMP 






L-ENDC 






ERA 


TTST 




SNZ 






= ELSF 






SPL 






1 — ENDC 






JMP 


XI 




ENDC 






-ENDC 
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The following example shows the same routine assembled without listing the skipped 
statements. 



0112 




» 


EXAMPLE OF C0NDITI0MAI ASRFM8LY 


0113 


000001 


VI 


enu 


1 


0114 


000003 


V2 


ERU 


3 


0115 


000001 


V3 


EQU 


1 


0116 


000000 


V4 


EOU 





0121 00337 


10 00375 




JST 


A3X 


0123 00340 


10 0045? 




JST 


B3x 


0124 00341 


04 00665 




STA 


TEMP 


0139 00342 


100400 




SPL 




0141 00343 


01 00301 




JMP 


XI 



The following example shows the same routine assembled using a different set of 
parameters without listing the skipped statements. 

ni?4 * EXAMPLE Or nONDITIOMAI ASSEMBLY 

0125 00 00 01 VI EOU 1 
°1?6 000003 V2 E0u 3 

0127 onooon \/3 eou n 

0126 000001 V4 equ 1 
0133 00337 10 00375 JST A3X 
0138 00340 10 0046? j^t c?X 

0144 00341 0? 00347 LPA =-1 

0145 0034? o 06 00665 AHQ TFMP 

0146 00343 04 00665 STA T C MP 

0148 00344 05O0666 EPA TTST 

0149 00345 101040 s m 2 
0153 00346 01 00301 JMP XI 

In the following example VI is greater than V2. 



0101 




* 


EXAMPLE OF ro^DITTOMA! 


ASSEMBLY 


0102 


7 


VI 


EOU 7 




0103 


3 


V? 


EOU 3 




0104 





V3 


EOU 




0105 


177770 


V4 


EOU -* 




0106 






FAR 
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SPECIAL SYMBOLS 

***, Op Code Zero; 
PZE, Op Code Zero 



LOCATION 



Normal 



OPERATION 



PZE, or PZE* 



OPERAND 



Normal. Indexing may be 
specified. 



These two pseudo-operations, *** and PZE, are assembled and loaded as memory 
reference instructions with an operation code of zero. Indirect addressing and indexing 
may be specified. The sector bit is set or reset depending on the sector in which the 
address is located. Since there is no memory reference instruction with an operation 
code of zero, it is expected that the proper code will be inserted during program execution 
and before attempting to execute this instruction. 

ERROR CODE 

The DAP- 16 Assembler is able to detect various types of syntax errors commonly 
made during the coding of programs. These errors are indicated by one-letter error 
codes printed in the left margin of the assembly listing (see Figure 2-4 for an example). 

Each error is treated differently; some result in zero in the erroneous field, others 
result in a guess at the desired result. In the case of multiply defined symbols, the first 
symbol definition is used. If the operation code is illegal for the object computer configura- 
tion indicated, the line will be properly assembled but flagged with an O-error. At the 
end of the assembly the following message is printed (DAP- 16 Mod 2): 0000 WARNING 
OR ERROR FLAGS (DAP- 16 prints NO ERRORS IN ABOVE ASSEMBLY). The number of 
errors is printed instead of 0000 if there are any (** for DAP- 16). 

See Table 3-3 for a list of the error flags and their meaning. 
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TABLE 3-3. WARNING AND ERROR FLAGS 



A Address field missing where normally required; error in address format 

C Erroneous conversion of a constant; address field of data-defining pseudo- 

operation in improper format 

E Executable code generated before EXT pseudo-operation; external name modi- 

fied by addition; external name used in address field of something other than 
a memory reference instruction 3 - 

F Major formatting error 

L Label (location field) missing where normally required; error in label symbol 

M Multiply defined symbol 

O Operation field blank or not recognized; operation field not legal for object 

configuration 

P Phase error (different definitions in first and second passes) 

R Relocation assignment error 

S Address of variable field expression not in sector being processed or sector 

zero (applicable only in LOAD mode) 

T Improper use of index subfield; error in index subfield 

U Undefined symbol 

V Unclassified error in address field of multiple -subfield pseudo-operation 

Z Conditional assembly error; ELSE used outside of conditional assembly; 

END reached before all IFs matched by ENDCs a 



a 



a 



DAP- 16 Mod 2 only. 

EXAMPLE 

Figure 3-6 shows a general flow chart of three programs that convert a binary num- 
ber to an ASCII octal number and print it on the ASR; the assembled programs and their 
cross-reference listings are shown in Figures 3-7, 3-8, and 3-9. These three programs 
use a special format known as a Defined Character Address (DCA) for pointers to half- 
words. Bits 2 through 16 of the DCA are a pointer (DAC) to the word, and bit 1 tells which 
half of the word is to be accessed, with meaning the left (high-order) half and 1 meaning 
the right (low-order) half). 

These three programs operate correctly when loaded into core and linked to another 
program that supplies the number to convert. However, they were designed to show various 
aspects of assembly language programming and therefore are not as efficient as they could 
be. 
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MAIN PROGRAM 





SAVE NUMBER 




CONVERTED 


( 




CONV 
WITH POINTER TO 
OUTPUT STORAGE 
AREA 


t 




OUTP 






' 




f STOP ) 









( ENTER J 



PUT POINTER TO OUTPUT 
STORAGE AREA IN X-REGISTER 



PUT 2 SPACES IN FIRST WORD 
OF OUTPUT STORAGE 



INCREMENT POINTER AND 
STORE IT IN ABSOLUTE 'BOZ 



PLACE NUMBER TO BE 
CONVERTED IN B-REGISTER 



NOT 
DONE 



SHIFT IN 3 BITS OF 
B-REGISTER 



E 



CHANGE TO 
ASCII NUMBER 



IN 
WITH POINTER 
TO '602 



UPDATE 
WITH POINTER 
TO '602 



CLEAR A REGISTER 



UPDATE ZCNT 



MOVE RETURN POINTER 

PAST POINTER TO OUTPUT AREA 



c 



-Q 



C ENTER J 



SAVE BYTE 
IN TEMP 



SAVE POINTER 
TO OCA IN 
TMAD 



MOVE RETURN 
POINTER PAST 
POINTER TO DCA 



PICK UP DCA, SAVE RIGHT/ 
LEFT IN C BIT AND SAVE 
POINTER IN TMAD 



PICK UP BVTE FROM TEMP 
AND MOVE TO PROPER HALF 
OF A, RETURN IT TO TEMP 



PICK UP OLD CONTENTS OF 
WORDWHEREBYTEISTOGO 



CLEAR PROPER HALF 



PUT NEW BYTE IN WORD 
AND REPLACE IT 



f RETURN J 



INITIALIZE ZCNT 
FOR 6 PASSES 



CLEAR A< REGISTER AND 
SHIFT IN SIT 1 OF B-REGISTER 



6 



Figure 3-6. Flow Chart for Example in Figures 3-7 thru 3-9 (Part 1 of 2) 
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C E " TEB ) 



PLACE POINTER TO 
COMMON LOCATION 
INPTR 



INITIALIZE X REGISTER 
FOR 4 TRANSFERS 





MOV 1 






MOVE WORD FROM LOCATION 
POINTED TO BY PTR TO WORD 
OF BOF, INDEXED 














1 






INCREMENT PTR AND 
XREGISTER 






MOT 
DONE 






DONE 




SET ASR FOR OUTPUT 
MODE AND WAIT FOR 
NOT BUSY 








' 




LFCR 










PLACE POINTER TO 
BUFFER IN PTR 






' 




INITIALIZE XREGISTER 
FOR 6 TRANSFERS 






PRNT ' 








OUT 
WITH POINTER 
TO PTR 














1 








OUTPUT IT 

WHEN READY 




1 


HOT 

DONE 


UPDATE 
WITH POINTER 
TO PTR 














1 






UPDATE 
XREGISTER 








DONE 




LFCR 






' 





C RETURN J 



C EMTEB ) 



SAVE POINTER TO 
DCAINTMAD 



MOVE RETURN POINTER 
PAST POINTER TO DCA 



PICK UP DCA, SAVE RIGHT/ 
LEFT INC, SAVE POINTER 
IN TMAD 



PICK UP WORD POINTED 
TO BY TMAD 



SAVE PROPER HALF AND 
PLACE IN RIGHT HALF 
OF A REGISTER 



C RETURN J 



C ENTER J 



SAVE POINTER TO 
DCAINTMAD 



MOVE RETURN POINTER 
PAST POINTER TO DCA 



ROTATE IT LEFT 1 BIT, 
ADD 1, ROTATE IT 
RIGHT 1 BIT 



RETURN IT TO 
ORIGINAL LOCATION 



f RETURN J 



C ENTER ^ 


'' 


OUTPUT CARRIAGE 
RETURN WHEN NOT BUSY 



OUTPUT LINE FEED 
WHEN NOT BUSY 



C RETURN J 



Figure 3-6. Flow Chart for Example in Figures 3-7 thru 3-9 (Part 2 of 2) 
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SECTION IV 
USE OF FORTRAN PROGRAMS 



FORTRAN and DAP- 16 programs may be freely intermixed in a memory load and can 
communicate with each other through either COMMON, the argument transfer program 
F$AT, or argument transfer routines generated by the programmer. Entry points in a 
DAP- 16 subroutine are declared using the ENT andSUBR pseudo-operationand in FORTRAN 
by the SUBROUTINE statement. The linkages are established by the DAP pseudo-operations 
EXT, XAC, and CALL, and by the FORTRAN statement CALL, Control is returned to the 
calling program by an assembly IMP* or a FORTRAN statement RETURN. 

COMMON 

Subroutines may transfer variables through COMMON without explicitly naming the 
variables in a subroutine call. Because FORTRAN COMMON and DAP- 16 COMMON are 
handled differently, the user must deliberately locate the appropriate COMMON at the same 
place in core, COMMON may be relocated in the following ways. 

a. During execution of TABLESIZ (that is, at the first execution of a DAP- 16 Mod 2 
Assembler System). This option is not possible with the conventional DAP- 16 
or FORTRAN. 

b. During a DAP- 16 Mod 2 assembly, using SETC. 

c. During any assembly or FORTRAN compilation, by establishing blocks of dummy 
variables to move the effective COMMON location, 

d. When loading, FORTRAN COMMON may be displaced by the operator. 

The location of COMMON is further complicated by the Disc and Drum Operating Systems 
(DOPs), When using this method of communication the exact location of both FORTRAN and 
DAP- 16 COMMON must be known for the local installation. 

ARGUMENT TRANSFER SUBROUTINE F$AT 

The compiler inserts a call to this subroutine at the beginning of FORTRAN- coded 
subroutines. F$AT transfers pointers (DACs) to the variables. being communicated between 
the calling program and the subroutine. No call to F$AT is made for subroutines that 
need no arguments. 

Calling a Subroutine 

The sequence on the following page is used to call a subroutine that transfers argu- 
ments via F$AT. The variables are listed in the same order as in a FORTRAN CALL 
statement. If there is only one argument, the terminal zero must be omitted: 
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(L ) CALL subroutine name 

(L+l) DAC <first variable> 

(L+2) DAC < second variable> 

(L+n) DAC <nth variable > 

(L+n+1) OCT Zero must be omitted for n = 1 

(L+n+2) Return point 

The DACs to the variables can be indirect pointers; F$AT tracks down the indirect 
links and transfers a direct pointer. Note that variables themselves are never transferred. 
The reason for this is that the length of the variable is not known (it could be any length, 
since arrays are acceptable variables). 

Calling F$AT 

By convention, the first action of a subroutine is to call F$AT. Therefore the location 
preceeding the call points to the first argument to be transferred. F$AT transfers the 
arguments associated with the words following the call to F$AT. Then, F$AT increments 
the pointer to the calling program so that it now points to the conventional return point 
(following the zero). For example: 

(L ) <name> DAC ** Subroutine entry point 

(L+l) CALL F$AT Must immediately follow entry 

(L+2) DEC <number of arguments, n> 

(L+3) <name> DAC ** First argument address goes here 

(L+n+2) <name> DAC ** nth argument address goes here 

(L+n+3) Return point for F$AT 

The subroutine call may include extraneous arguments following those used by the 
called subroutine. Although only the number of arguments specified in L+2 of the call to 
F$AT are transferred, the return pointer is incremented until it points to the word following 
the zero in the subroutine call. 

DAP- 16 MAIN PROGRAM WITH FORTRAN SUBROUTINE 

The DAP-16 main program and FORTRAN subroutine combination may be advantageous 
when assembly language programs must perform arithmetic or logical calculations, input/ 
output operations, or when FORTRAN procedures may be used to advantage. The DAP-16 
main program must generate the call itself. Figures 4-1 through 4-5 present an example 
of this procedure. The DAP-16 AVGCOL program in Figure 4-1 calls another DAP-16 
program MESURE (not shown) which accumulates single -precision floating-point data (for 
example from a peripheral measuring device). These numbers are accumulated in a buffer 
with the external name MINP. The number of points collected in a given run is stored in a 
location with the external name MNUM. Each time MESURE returns to AVGCOL, AVGCOL 
calls a FORTRAN subroutine STDDEV which calculates the average and standard deviation. 
STDDEV then prints the run number, the values, the average, and the standard deviation and 
passes these calculated values back to AVGCOL. In this example, AVGCOL does not use 
the calculated values. 
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Figure 4- 


1. Portion of DAP- 1 



EXTERNAL NAME 
INITIALIZE RUN 

NUMBER 
SUBROUTINE TO ACCUMULA 
FORTRAN PROGRAM TO CAL 

MEAN AND STANDARD DE 
FIRST ARGUMENT (NRUN I 
SECOND ARGUMENT <NPT I 
THIRD ARGUMENT (PT IN 
FOURTH ARGUMENT (DEV I 
FIFTH ARGUMENT <AMEAN 



TE VALUES 
CULATE 
VIATION 
N FORTRAN) 
N FORTRAN) 
FORTRAN) 
N FORTRAN) 
IN FORTRAN) 



INCREMENT RUN NUMBER 
COLLECT NEXT BATCH OF DATA 



RUN NUMBER 

POINTER TO NUMBER OF POINTS 
POINTER TO DATA BUFFER 
REAL STANDARD DEVIATION 
REAL AVERAGE 



Portion of DAP- 16 Program Calling FORTRAN Subroutine STDDEV 



Figure 4-2 presents the FORTRAN subroutine STDDEV. An expanded listing is given 
in Appendix A. Figure 4-3 presents a load map for AVGCOL, MESURE, and STDDEV. 
Figure 4-4 is a typical output from STDDEV. 

SUBROUTINE STDDEV CNRUN* NPT* PT* DEV* AMEAN) 
DIMENSION PT(IOO) 
SX = 
SX2 = 

DO 100 I = 1*NPT 
SX2 = SX2 + (PT(I))*(PT(I>) 
100 SX = SX + PT(I) 
ANPT = NPT 

DEV = SQRT(SX2/ANPT-(SX/ANPT)*(SX/ANPT>> 
AMEAN = SX/ANPT 

WRITE (1*1000) NRUN* <PT<J)* J = 1*NPT) 
1000 FORMAT (////12H RUN NUMBER * 15// < E 1 1 . 4* 4E1 4. 4) ) 

WRITE (1*2000) AMEAN* DEV 
2000 FORMAT ( I 9H ARITHMETIC MEAN = *E14-5* 
1/22H STANDARD DEVIATION = * El 1.5) 
RETURN 
END 
SO 

Figure 4-2. FORTRAN Subroutine STDDEV 
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REAL 03306 

LS22 03306 

HS22 03316 

NS22 03334 

FSAT 03346 

ARG5 03430 

F-5W1 03450 

OSAP 03544 

CSAC 03616 

CSAF 03622 

F$IC 03632 

F$AR 04155 

FSC8 04333 

FSER 06252 

FSHT 06262 

ACl 06320 

AC2 06 321 

AC3 06322 

AC4 06323 

ACS 06324 
37777 



Figure 4-3. Loader Map for AVGCOL, MEASURE, and STDDEV 



*L0W 


01000 


* START 


01000 


*HIGH 


06326 


•NAMES 


7 1 501 


*C0MN 


37777 


• BASE 


00300 


AVGCCL 


01000 


MESURE 


01024 


MNUM 


01564 


MINP 


01565 


STDDEV 


02010 


SQRTX 


02306 


SORT 


02306 


C$12 


02422 


5 522 


02454 


AS22 


02462 


M$22X 


02704 


MS22 


02704 


DS22X 


03065 


DS22 


03065 


SNGL 


03306 



RUN NUMBER 7 

0.7680E-01 0.7520E-01 0.7270E-01 0.7100E-01 0.7570E-01 

0.7350E-01 0.7510E-01 0.7320E-01 0.7010E-01 0.7270E-01 

0.7610E-01 0.6970E-01 0.7410E-01 0.7460E-01 0.7380E-01 

0.7320E-01 0-7310E-01 0.7310E-01 0.7110E-01 0.7150E-01 

0.7510E-01 0.7640E-01 0.7120E-01 

ARITHMETIC MEAN = 0-73435E-01 

STANDARD DEVIATION = 0.19745E-02 



Figure 4-4. Output From STDDEV 
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FORTRAN MAIN PROGRAM WITH DAP- 16 SUBROUTINE 

The FORTRAN main program and DAP- 16 subroutine combination is required when 
tasks which cannot be performed in FORTRAN must be done. In this case the DAP-16 
program must handle the call to F$AT, or transfer the required arguments directly. 

Figures 4-5 and 4-6 provide a sample of this combination. The FORTRAN main 
program requires input from paper tape in a special format as shown in Figure 4-7. The 
FORTRAN main program passes the start of message character (which may vary from 
application to application) to the DAP-16 subroutine. The subroutine then reads the tape. 
The first two words are integer values passed back through the calling parameters. The 
next two words are a real value also passed back through the calling parameters. The next 
four words are a complex value passed to the main program through COMMON. The 
COMMON base must be set to the same value by one of the methods mentioned above. 
Notice that X3 is part of COMMON in the FORTRAN program, but not involved in calling 
READT. 

Figure 4-8 shows another version of READT that does not use F$AT but instead 
transfers the arguments directly. 



COMMON K10* 10>» Jl> J2*X1*X3,X3 

COMPLEX X2>X3 



I START = 129 

129 IS OCTAL 201 (START OF MESSAGE) 

CALL READT CISTART> Jl * J2> XI) 



Figure 4-5. FORTRAN Calling Sequence for DAP-16 Subroutine READT 
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SUBR 


READT, TAPE 




REL 




TAPE 


DAC 


** 




CALL 


FSAT 




DEC 


4 


CHAR 


DAC 


** 


PI 


DAC 


** 


P2 


DAC 


** 


P3 


DAC 


** 




LDA 


CMPT 




STA 


CMNl 




OCP 


•oooi 




LDA* 


CHAR 




STA 


SCM 




INA 


•1001 




JMP 


*-l 




ERA 


SOM 




SZE 






JMP 


*-4 




jsr 


FORM 




STA* 


PI 




jsr 


FORM 




STA* 


P2 




JST 


FORM 




STA* 


P3 




IRS 


P3 




JST 


FORM 




STA* 


P3 


* 




NOW GET THE 




LDX 


= -4 


LOOP 


JST 


FORM 




STA* 


CMNl 




IRS 


CMNl 




IRS 







JMP 


LOOP 




OCP 


•0101 




JMP* 


TAPE 


* 






FORM 


DAC 


** 




INA 


M001 




JMP 


*-l 




ICR 






INA 


•0001 




JMP 


*-l 




JMP* 


FORM 


CN 


COMN 


8 


CMPT 


DAC 


CN 


CMN1 


BSZ 


1 


SCM 


OCT 
END 






ENTRY POINT CUSED AS POINTER BY F$AT> 
CALL ARGUMENT TRANSFER SUBROUTINE 
FOUR ARGUMENTS TO BE TRANSFERRED 
POINTER TO CHAR GOES HERE 
POINTER TC PI GOES HERE 
POINTER TO P2 GOES HERE 
POINTER TC P3 GOES HERE 
PICK UP COMMON POINTER 
STORE IN TEMPORARY LOCATION 
TURN ON PAPER TAPE READER 
PICK UP START OF MESSAGE CHARACTER 
SAVE IT 

CLEAR A AND INPUT CHARACTER 
JELAY UNTIL READY 

IS IT START-OF-MESSAGE CHARACTER? 
IGNORE IF IT IS NOT 
NOPE, TRY ANOTHER ONE 

FORM A WORD FROM THE NEXT TWO CHARACTERS 
THIS IS PI* RETURN IT TO CALLING PROGRAM 
FORM ANOTHER WORD 
THIS IS P2; RETURN IT 
FORM ANOTHER WORD 
THIS IS THE FIRST WORD OF P3 
POINT TO THE SECOND WORD 
FORM THE SECOND WORD OF P3 
STORE IT 
THE FOUR WORDS OF THE COMPLEX VARIABLE 
FOUR WORDS TO 3E FORMED 
FORM A WORD 

STORE IN COMMON LOCATION 
POINT TO NEXT COMMON LOCATION 
UPDATE INDEX 

LOOP UNTIL 4 WORDS TAKEN CARE OF 
NOW TURN OFF THE TAPE READER 
AND RETURN TO CALLING PROGRAM 

ENTRY POINT 

CLEAR A AND INPUT CHARACTER 

DELAY UNTIL READY 

INTERCHANGE AND CLEAR RIGHT HALF 

INPUT CHARACTER 

INPUT SECOND CHARACTER 

RETURN WITH WORD IN A REGISTER 

POINTER TO FIRST WORD OF COMPLEX BLOCK 

TEMPORARY LOCATION FOR POINTER 

STORAGE FOR START OF MESSAGE CHARACTER 



Figure 4-6. DAP- 16 Subroutine READT 
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FRAME 

1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 



SOW! 



INTEGER 



INTEGER 



REAL 



COMPLEX 



TAPE 



Figu] 


re 4-7. Pape 


SU9R 


READT^TAPE 


REL 




DAC 


** 


LDA* 


TAPE 


JST 


I NO 


STA 


CHAR 


IRS 


TAPE 


LDA* 


TAPE 


jst 


I NO 


STA 


PI 


IRS 


TAPE 


LDA* 


TAPE 


JST 


I,MD 


STA 


P2 


IRS 


TAPE 


LDA* 


TAPE 


JST 


INO 


STA 


P3 


IRS 


TAPE 


LDA* 


TAPE 


SZE 




JMP 


*-3 


IRS 


TAPE 


LDA 


CMPT 


STA 


CMN1 


CCP 


•0001 


LDA* 


CHAR 


STA 


SOM 


INA 


•1001 


Figure 4-8. DAP 



Paper Tape Input Format (for Figures 3-4 and 3-5) 



ENTRY POINT (USED AS POINTER BY FSAT) 

PICK UP FIRST ARGUMENT (CHAR) 

RUN DOWN INDIRECT LINKS 

POINTER TO SOM CHARACTER 

PC INT TO NEXT ARGUMENT (PI) 

PICK IT UP 

RUN DOWN INDIRECT LINKS 

STORE IT 

POINT TO NEXT ARGUMENT (P2) 

PICK IT UP 

RUN DOWN INDIRECT LINKS 

STORE IT 

POINT TO NEXT ARGUMENT (P3> 

PICK IT UP 

RUN DOWN INDIRECT LINKS 

STORE IT 

POINT TO NEXT ARGUMENT OR ZERO 

PICK IT UP 

DONE IF IT IS ZERO 

KEEP INCREMENTING UNTIL ZERO REACHED 

POINT TO RETURN POINT 

PICK UP COMMON POINTER 

STORE IN TEMPORARY LOCATION 

TURN ON PAPER TAPE READER 

PICK UP START OF MESSAGE CHARACTER 

SAVE IT 

CLEAR A AND INPUT CHARACTER 

DAP- 16 Subroutine READT, Transferring Arguments 
Without Calling F$AT 
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JMP 


*-l 




ERA 


SOM 




SZE 






JMP 


*- A 




jsr 


FORM 




STA* 


PI 




jst 


FORM 




STA* 


P2 




JST 


FORM 




STA* 


P.3 




IRS 


P3 




JST 


FCRM 




STA* 


P3 


* 




NCW GET 




LDX 


= -4 


LCCP 


' JST 


FORM 




STA* 


CMM1 




IRS 


CMN 1 




IRS 







JMP 


LOOP 




OCP 


'0101 




JMP* 


TAPE 


* 






FORM 


DAC 


** 




INA 


•1001 




JMP 


*-l 




ICR 






INA 


•oooi 




JMP 


*-l 




JMP* 


FCRM 


* 






IiMD 


DAC 


** 


* 


SM I 






JMP* 


I NO 




SSP 






STA 


TEMP 




LOA* 


TEMP 




JMP 


IND+1 


* 






CM 


CCMN 


8 


CMPT 


DAC 


CN 


CMN1 


35Z 


1 


SCM 


OCT 





TEMP 


8SZ 


1 


CHAR 


DAC 


** 


PI 


DAC 


** 


P3 


DAC 


** 


P3 


DAC 

END 


** 



DELAY UNTIL READY 

IS IT START-CF-MESSAGE CHARACTER? 
IGNORE IF IT IS NOT 
NOPE* TRY ANOTHER ONE 

FORM A WORD FROM THE NEXT TWO CHARACTERS 
THIS IS Pii RETURN IT TO CALLING PROGRAM 
FCRM ANOTHER WCRD 
THIS IS P2i RETURN IT 
FORM ANOTHER WORD 
THIS IS THE FIRST WORD OF P3 
POINT TO THE SECOND WORD 
FORM THE SECOND WORD OF P3 
STORE IT 
THE FOUR WORDS OF THE COMPLEX VARIABLE 
FOUR WORDS TO 3E FORMED 
FORM A WORD 

STORE IN COMMON LOCATION 
POINT TO NEXT COMMON LOCATION 
UPDATE INDEX 

LOOP UNTIL A WORDS TAKEN CARE OF 
NCW TURN OFF THE TAPE READER 
AND RETURN TO CALLING PROGRAM 

ENTRY POINT 

CLEAR A AND INPUT CHARACTER 

DELAY UNTIL READY 

INTERCHANGE AND CLEAR RIGHT HALF 

INPUT CHARACTER 

INPUT SECOND CHARACTER 

RETURN WITH WCRD IN A REGISTER 

ENTRY POINT FOR REMOVING ALL 

INDIRECT LINKS 
INDIRECT POINTER? 
NO—RETURN 

YES— REMOVE INDIRECT FLAG AND TRY AGAIN 
SAVE IT 

PICK UP WHAT IT POINTS TO 
AND CHECK IT FOR INDIRECT 



POINTER TO FIRST WCRD CF COMPLEX BLOCK 
TEMPORARY LOCATION FOR POINTER 
STORAGE FOR START OF MESSAGE CHARACTER 
STORAGE USED FOR RUNNING DOWN INOIRECTS 
POINTER TO CHAR GOES HERE 
POINTER TO PI GOES HERE 
POINTER TO P3 GOES HERE 
POINTER TO P3 GOES HERE 



Figure 4-8. DAP- 16 Subroutine READT, Transferring Arguments 

Without Calling F$AT (Cont. ) 
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SECTION V 
PERFORMING AN ASSEMBLY (DAP- 16 MOD 2) 



Initially, the Assembler along with the proper IOS (Input/ Output Supervisor) subroutines 
must be loaded. Normally a system is generated rather infrequently and a reloadable core 
dump (binary record) made for general use. The core dump is loaded from paper tape, cards, 
disc, etc. whenever an assembly is to be performed. 

The source (tape, deck, or disc file) is loaded on the proper input device and the bits 
of the A-Register are set to indicate the mode of assembly and the devices being used for 
input and output (see Figure 5-1). Some Input/ Output Supervisors also require a B-Register 
setting. Set the P-Register to '400 and push the START button (see Table 5-1 for other 
starting addresses). 

At the end of the first pass the computer will halt. If a two-pass assembly is being 
performed, press the START button when the source has been repositioned. When the 
source is on magnetic tape or disc, automatic positioning can be specified and the computer 
in this case does not halt. 



1 


2 


3 


4 


5 


6 


7 


8 


9 


10 11 12 


13 14 15 16 














-^i 


1 1 1 1 1 1 1 1 




(SEE INPUT/OUTPUT 
SUPERVISORS FOR DETAILS) 



= if no halts should be made before punching object 
text blocks 

= 1 if a halt should be made before and after the 
output of each block of object text. This is to 
allow manual punch control on an ASR - 33 so that 
the object tape is not cluttered with the Assembly 
Listing 

= to print Symbol Table at the end of the assembly 
= 1 to inhibit printing of the Symbol Table 

= to list all statements 

= 1 to list only statements with warning or error flags 

= to inhibit listing of conditional pseudo-operations 
and statements skipped as a result of inhibited 
assembly 

= 1 to list conditional pseudo-operations and statements 
skipped as a result of inhibited assembly 

= for one-pass assembly 
= 1 for two-pass assembly 



Figure 5-1. A-Register Settings for Assembler Initialization 
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TABLE 5-1. ASSEMBLER STARTING ADDRESSES 



'400 
'401 
'402 
'403 
'404 



Start normal assembly- 
Continue assembly (used after halts for read errors etc. ) 
Start subroutine assembly (no end-of-file will be placed in the object text) 
Terminate assembly (place end-of-file in the object text) 

Restart second pass for additional listing or additional object text (A-Register 
bit changes accepted). 



ESTIMATION OF SYMBOL TABLE SIZE 

The Symbol Table occupies the core area above the Assembler System. If this table 
overflows, the assembly cannot be performed. Each entry occupies three words, and as 
a general rule one entry is produced for every four or five lines of source text (2/3 words 
in the Symbol Table per line of text). The programmer may minimize the number of entries 
by use of displacements from symbolic values or the asterisk element. 

ASSEMBLER SUPPORT PROGRAMS 

The following programs must be linked to the Assembler for proper operation. The 
Input/Output Supervisors are described following discussion of these programs. 

016-DECS, 016-DECL 

These programs, 016-DECS and016-DECL, provide the ASCII-to-binary conversion 
capability of the Assembler. 016-DECS must be used for systems with up to 4K memory 
locations. However 016-DECS does not provide floating-point or double -precision con- 
versions. 016-DECL may be used with any system having more than 4K memory locations. 
The full range of conversions as described under DEC, DBP, OCT, and HEX is available 
withOl6-DECL. 

SYMLIST, Symbol Table Printer 

The program SYMLIST performs an alphabetic sort of all entries in the Symbol Table 
and prints out these entries, four per line, following the assembly. The last value printed 
is the one for symbols established by SET. Following the value of each symbol is a blank 
if the symbol is relocatable, an A if it is absolute, and an E if it is external (external 
symbols always equal zero). The Symbol Table may be suppressed by entering a 1 in bit 4 
of the A-Register when starting the Assembler. Figures 3-6 and 3-7 show two assemblies 
with Symbol Tables. 

TABLESIZ 

The last Assembler support program loaded must be TABLESIZ. This program is called 
at the start of the first assembly by the Input/Output Supervisor. Functionally, TABLESIZ 
derives the top of memory and returns this location and the COMMON base ('177 locations 
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below the top of memory) to the supervisor. The symbol table overlays TABLESIZ, and it 
is not called for subsequent assemblies. If Sense Switch 1 is set during execution of 
TABLESIZ, the computer will halt with the highest memory location in the A-register. This 
location may then be changed manually. The computer willthenhalt again with the COMMON 
base displayed for the operator to change if desired. 

INPUT/OUTPUT SUPERVISORS 

DAP- 16 input/ output supervisors are designed to operate with standard Honeywell 
drivers (using their calling sequences and their expected results). These drivers are 
described in the Programmers Reference Manuals for the specific peripheral devices. 

One IOS program and the appropriate driver programs must be linked within an 
assembler system along with the programs listed in the previous section. TABLESIZ 
must be the last program (highest core address) in the system following the drivers. 

NOTE 

This section generally indicates the features available to 
the programmer in the assembler system as generated 
from standard software. An installation that performs 
a large number of assemblies will normally find it worth- 
while to tailor an IOS to the installation standard. This 
tailoring may include card-to-tape or card-to-disc trans- 
fer on the first pass, source blocking, simultaneous 
peripheral transfer and computation, and operating system 
interfaces. Some of these features are available on a 
standard item basis. 



Dedicated IOS Programs 

Computer systems with 4K memory locations must use one of the dedicated input/ 
output supervisors. Each of these IOS programs uses a fixed set of peripheral devices. 
Therefore, no bits need to be set for device selection when starting the assembly. Table 
5-2 lists the programs and the devices to which they are dedicated. 

TABLE 5-2. DEDICATED INPUT/OUTPUT SUPERVISORS 



Name 



IOS-OAAA 
IOS-ORAA 

IOS -OR PA 



Symbolic Input 



ASR 

High-Speed 

Paper Tape 

Reader 

High-Speed 

Paper Tape 

Reader 



Object Text 



ASR 

ASR 



High-Speed 

Paper Tape 

Punch 



Listing 



ASR 
ASR 

ASR 
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With any of these dedicated supervisors Sense Switches 3 and 4 respectively may be 
used to suppress the object text and listing. If Sense Switch 3 is set during the assembly, 
no object will be produced. If Sense Switch 4 is set, no listing will be produced. 

IOS-016D 

IOS-016D is the supervisory program that permits a choice of input and output de- 
vices. This program must be used only on computer systems with 8K or more memory 
locations. Table 5-3 lists the options available for input and output with this supervisor 
The octal numbers are entered in the A-register before starting the assembly. Table 5-4 
lists the B-register settings used when magnetic tape is specified. These settings define 
the file more fully for the supervisor. 

When IOS-016D is used with a disc or drum the appropriate DOP (Disc Operating 
Program) must be present. There is a DOP for each standard disc and drum in the Honey- 
well product line. DOP asks the operator which files (by name) are to be attached as 
pseudo-devices for the current assembly. Access to these files is handled by DOP. 



TABLE 5-3. DEVICE SELECTION WITH IOS-016D 



Symbolic Input 
Bits 8-10 

1 

2 

3 
4 

5 

6-7 

Object Text Outputs 
Bits 11-13 


1 
2 

3 

4 
5 

6-7 

Listing Output 
Bits 14-16 


1 
2 

3 

4 

5 

6-7 



IOS-016D 



Undefined 

ASR 

High-Speed Paper 

Tape Reader 
Card Reader 
Magnetic Tape 
Disc or Drum 

Undefined 



No object text 

ASR 

High-Speed Paper 

Tape Punch 
Card Punch 
Magnetic Tape 
Disc or Drum 

Undefined 



No listing 

ASR 

High-Speed Paper 

Tape Punch 
Line Printer 
Magnetic Tape 
Disc or Drum 

Undefined 
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TABLE 5-4. B-REGISTER SETTINGS FOR MAGNETIC TAPE INPUT/OUTPUT 



Bits 1-2 
Bits 3-4 
Bits 5-6 
Bit 7 



Bits 9-16 



Default is logical unit 1. 
Default is logical unit 2. 
Default is logical unit 3. 



Logical Tape Unit Number for source 
Logical Tape Unit Number for object. 
Logical Tape Unit Number for listing, 

= Normal operation. 

= 1 Continuous mode operation. The computer will immediately 
halt. At this time the operator should enter the number of 
files to be processed into the B-Register. Zero means all 
files until a double EOF (blank file) is encountered. The 
computer will not stop again until the indicated number of 
assemblies have been performed. Operative only with 
magnetic tape input. 

How many files to skip before starting the assembly. 
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SECTION VI 
PERFORMING AN ASSEMBLY (DAP-16) 



Initially, the Assembler along with the proper IOS (Input/ Output Supervisor) subroutines 
must be loaded. Normally a system is generated rather infrequently and a reloadable core 
dump (binary record) made for general use. The core dump is loaded from paper tape, cards, 
disc, etc. , whenever an assembly is to be performed. 

The source (tape, deck, or disc file) is loaded on the proper input device and the bits 
of the A-Register are set to indicate the mode of assembly and the devices being used for 
input and output (see Figure 6-1). Some Input/ Output Supervisors also require a B-Register 
setting. Set the P-Register to '400 and push the START button (see Table 6-1 for other 
starting addresses). 

At the end of the first pass the computer will halt. If a two-pass assembly is being 
performed, press the START button when the source has been repositioned. When the 
source is on magnetic tape or disc, automatic positioning can be specified and the computer 
in this case does not halt. 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 




I I I I 



_L 



I ■ ■ I ■ 



SEE INPUT/OUTPUT 
SUPERVISORS FOR DETAILS 



= for one - pass assembly 
■ 1 for two - pass assembly 



Figure 6-1. A-Register Settings for Assembler Initialization 



TABLE 6-1. ASSEMBLER STARTING ADDRESSES 



'400 Start normal assemble 

'401 Continue assembly (used after halts for read errors etc. ) 

'402 Start subroutine assembly (no end-of-file will be placed in the object 

text) 
'403 Terminate assembly (place end-of-file in the object text) 

'404 Restart second pass for additional listing or additional object text 
(A-Register bit changes accepted). 



6-1 



ESTIMATION OF SYMBOL TABLE SIZE 

The Symbol Table occupies the core area above the Assembler System. If this table 
overflows, the assembly cannot be performed. Each entry occupies three words, and as a 
general rule one entry is produced for every four or five lines of source text (2/3 words in 
the symbol table per line of text). The programmer may minimize the number of entries by 
use of displacements from symbolic values or the asterisk element. 

ASSEMBLER SUPPORT PROGRAMS 

The following programs must be linked to the Assembler for proper operation. The 
Input/ Output Supervisors are described following the discussion of these programs. 

DECCS, DECCL 

DECCS and DECCL provide the ASCII-to-binary conversion capability of the Assembler. 
DECCS must be used for systems with up to 4K memory locations. DECCS does not provide 
floating-point or double -precision conversions. DECCL may be used with any system having 
more than 4K memory locations. The full range of conversions as described under DEC, 
DBP, and OCT is available with DECCL. 

MEMSIZ, SETSIZ 

One of these programs (MEMSIZ or SETSIZ) must be the last assembler support 
program loaded (MEMSIZ for 4K systems; and SETSIZ for systems with more than 4K 
memory locations). MEMSIZ or SETSIZ is called at the start of the first assembly by the 
Input/ Output Supervisor. Functionally MEMSIZ or SETSIZ derives the top of memory and 
returns this location and the COMMON base ('177 locations below the top of memory) to the 
Supervisor. The Symbol Table overlays MEMSIZ or SETSIZ and the pertinent program is 
not called for subsequent executions. 

INPUT/ OUTPUT SUPERVISORS 

DAP- 16 Input/Output Supervisors are designed to operate with the standard Honeywell 
drivers (using their calling sequences and their expected results). These drivers are 
described in the Programmers Reference Manuals for specific peripheral devices. 

One IOS program and the appropriate driver programs must be linked within an 
Assembler system along with the programs listed in the previous section. TABLESIZ 
must be the last program (highest core address) in the system, following the drivers. 

NOTE 

This section generally indicates the features available to 
the programmer in the Assembler System as generated 
from standard software. An installation which performs 
a large number of assemblies will normally find it worth- 
while to tailor an IOS to the installation standard. This 
tailoring may include card-to-tape or card-to-disc transfer 
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on the first pass, source blocking, simultaneous peripheral 
transfer and computation, and operating system interfaces. 
Some of these features are available on a standard item 
basis. 



Dedicated IOS Programs 

Computer systems with up to 4K memory locations must use one of these dedicated 
input/ output supervisors. Each of these IOS programs uses a fixed set of peripheral devices. 
Therefore, no bits needtobe set for device selection when starting the assembly. Table 6-2 
lists the programs and the devices to which they are dedicated. 



TABLE 6-2. 


DEDICATED INPUT/OUTPUT SUPERVISORS 


Name 


Symbolic Input 


Object Text 


Listing 


IOS-5AAA 


ASR 


ASR 


ASR 


IOS-5RAA 


High-Speed 

Paper Tape 

Reader 


ASR 


ASR 


IOS-5CAA 


Card Reader 


ASR 


ASR 


IOS-5RPA 


High-Speed 

Paper Tape 

Reader 


High-Speed 

Paper Tape 

Punch 


ASR 


IOS-5CPA 


Card Reader 


High-Speed 

Paper Tape 

Punch 


ASR 



IOS-516X, IOS-516D 

IOS-516X and IOS-516D are supervisory programs that permit a choice of input and 
output devices. These programs must be used only on computer systems with 8K or more 
memory locations. Table 6-3 lists the options available for input and output with these 
supervisors. The indicated bits are filled in the A-register before starting the assembly. 
Table 6-4 lists the B-register settings used when magnetic tape is specified. These 
settings define the file more fully for the supervisor. 

When IOS-516D is used, the appropriate DOP (Disc Operating Program) must be 
present. There is a DOP for each standard disc and drum in the Honeywell product line. 
DOP asks the operator which files (by name) are to be attached as pseudo-devices for the 
current assembly. Access to these files is handled by DOP. 
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TABLE 6-3. DEVICE SELECTION WITH IOS-516X AND IOS-516D 





IOS-516X 


IOS-516D 


Symbolic Input 






Bit 2 


Teletypewriter 


Teletypewriter 


Bit 3 


High-Speed Paper 


High-Speed Paper 




Tape Reader 


Tape Reader 


Bit 4 


Card Reader 


Card Reader 


Bit 5 


Magnetic Tape 


Magnetic Tape 


Bit 6 


Teletypewriter with 


Teletypewriter with 




program halts for 


program halts for 




manual action 


manual action 


Bits 2-6 all = 


Undefined 


Disc 


Object Text Output 






Bit 7 


Teletypewrite r 


Teletypewriter 


Bit 8 


High-Speed Paper 


High-Speed Paper 




Tape Punch 


Tape Punch 


Bit 9 


Undefined 


Undefined 


Bit 10 


Magnetic Tape 


Magnetic Tape 


Bit 11 


No object text 


No object text 


Bits 7-11 all = 


Undefined 


Disc 


Listing Output 






Bit 12 


Teletypewriter 


Teletypewriter 


Bit 13 


High-Speed Paper 


High-Speed Paper 




Tape Punch 


Tape Punch 


Bit 14 


Magnetic Tape 


Magnetic Tape 


Bit 15 


Line Printer 


Line Printer 


Bit 16 


No listing 


No listing 


Bits 12-16 all = 


Undefined 


Disc 



Table 6-4. B-Register Settings for Magnetic Tape Input/ Output 



Bits 1-2 
Bits 3-4 
Bits 5-6 
Bit 7 



Bits 9-16 



Logical Tape Unit Number for source. Default is logical unit 1. 

Logical Tape Unit Number for object. Default is logical unit 2. 

Logical Tape Unit Number for listing. Default is logical unit 3. 

= Normal operation. 

= 1 Continuous mode operation. The computer will immediately 
halt. At this time the operator should enter the number of 
files to be processed into the B-Register. Zero means all 
files until a double EOF (blank file) is encountered. The 
computer will not stop again until the indicated number of 
assemblies have been performed. Operative only with 
magnetic tape input. 

How many files to skip before starting the assembly. 
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SECTION VII 

GENERATING AN ASSEMBLER SYSTEM 



This section describes the process of generating a DAP- 16 Mod 2 Assembly System 
from paper tape objects. Most systems (notably conventional DAP- 16) are generated anal- 
ogously. With conventional DAP- 16, however, care must be taken to avoid filling the base 
sector beyond '377, which would overwrite the assembler. To avoid filling that portion of 
the base sector, as many programs as possible should be loaded starting on a sector 

boundary. 

The system described in this section was generated on a computer with 12K memory 
locations. To generate this system on an 8K computer, at least one driver package must 
be left out. 016-DECL is used for decimal conversion, and the input/ output supervisor 
used is IOS-016D. 

LOADING LOADER 

LDR-APM must be loaded into high sectors of memory before starting. A self-loading 
form is available which loads in sectors 4 through 7. This programmay be usedto load the 
loader object starting at any even sector boundary. 

LOADING ASSEMBLER 

The starting location of the cross-sector references must be set as low as possible 
in order to provide enough room. The lowest possible address is '40. In this example, 
'60 was used. This address should be entered in the B-register before loading the assem- 
bler. If no B-register entry is made, '100 is assumed. If DMC, Real-Time Clock, 
Memory Lockout, Standard Interrupt, or Priority Interrupt/Memory Increment are used, 
their needs must be taken into account when making this setting. 

Enter relative location '3000 into the P-register. If the loader, for example, starts 
at the beginning of sector '24, '27000 is relative location '3000. Mount the assembler ob- 
ject text on the proper input device and press START. The computer will halt to receive 
the input device selection in the A-register. After the proper code is entered, press 
START again and the assembler will load. 

Generating Map 

Start the loader at relative location '3002. If the computer is allowed to print the en- 
tire map, MR will be printed and the computer will halt. Usually, the first six lines of the 
map (especially *HIGH and *BASE) are all that are pertinent. The remaining lines tell what 
additional routines are needed. The computer may be halted during a map with the MA/SI/ 
RUN Switch and the map printer reinitialized by again starting at relative location '3002. 
A map (or the first six lines of a map) taken after almost every load step is helpful. 
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After the assembler has been loaded, *HIGH should be in sector 5 and *BASE should 
be not far above the value initialized in the B-register. The next routine loaded will load 
at *HIGH and start its cross-sector links at *BASE. 

LOADING IOS-016D 

To conserve cross-sector references, the selected IOS should start at the beginning 
of sector 6 rather than at the current value of *HIGH. Set '6000 in the A-register, mount 
the IOS object, and start the computer at relative location '3003. From then on, the input 
device for the loader does not need to be reselected. 

LOADING 016-DECL 

This routine (or 016-DECS) need not start on a sector boundary. Therefore, it may 
be loaded simply by starting the computer at relative location '3003. 

LOADING SYMLIST 

This routine (if desired) may also be started at the current value of *HIGH. Start 
the computer at relative location '3003. 

LOADING IOS DRIVERS 

The following IOS driver packages can be loaded: ASR, Paper Tape Reader and Punch, 
Card Reader, Card Punch, Line Printer, and Magnetic Tape. Each of these packages in- 
cludes several routines, some of which are not used by the assembler system. For some 
input libraries, START must be pressed for reading each routine, whether or not it is 
actually loaded. Other libraries do not have stop codes other than the physical end of tape, 
which is a real convenience. 

When using magnetic tape, routine M$UNIT must be configured to the installation 
standard. See the appropriate magnetic tape programmers reference manual for details. 

Maps should be taken at this time to ensure that there is still room in the base sector. 
If the number of remaining locations is critical, specific routines should be loaded on 
sector boundaries. To do this, set the loading location in the A-register and start the 
loader at relative location '3003. 

The calls to any omitted packages should be satisfied by a dummy, which is an object 
text with entry points for each external name called. The safest way to handle these entries 
istopointeachonetoahaltorgenerateanerrormessage. Dummytexts (e.g. , DUMY-X16) 
are available from Honeywell upon request. 

Figure 7-1 shows the source of a dummy that satisfies calls to the card punch routines. 
Normally one dummy with a lengthy list of SUBR statements is used to avoid wasting opera- 
tor time and core space. 
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SU8R 


CSC3.DUMY 




SU>3R 


CnCS>DUMy 




REL 




DUMY 


OAC 
HLT 


** 




JMP 


*-l 




END 





RELOCATABLE SUBROUTINE 

ALL CALLS TO CARD PUNCH COME HERE 

HALT TO ALERT OPERATOR 

DO MOT ALLOW RESTART FROM HERE 



Figure 7-1. Dummy Example 



LOADING TABLESIZ 

After all other routines and the dummy have been loaded, the object for TABLESIZ 
should be loaded. This must be the last (highest in memory) routine loaded. 

PRODUCING SELF-LOADING CORE IMAGE 

Figure 7-2 shows the result in core for this example. This result may be preserved 
and reused if a self-loading (binary) core image text is made. For disc or drum systems, 
DOF can store the binary image on the disc or drum. A paper tape image may be made 
using PAL-AP. An 8K version of PAL-AP may be used as shown in Figure B-2. a 
PAL-C is the proper program for producing a core image in binary cards. Either of these 
programs must load on a sector boundary. Both are started at their relative location 
'000. 



a An 8K version of PAL-AP may be generated by the following steps. Use any Loader to 
load the object text of PAL-AP into sector 7 (the Loader is no longer needed and can be 
overwritten). Change the contents of location '7575 (for Rev E of PAL-AP) from , '7600 
to '17600. Execute PAL-AP starting at '7000 to dump the other version from 17000 to 
'17577. This dump is a version of PAL-AP that will load into, and execute properly from 
the uppermost sector of an 8K memory. It may be used to dump core from 70 to 16777. 



the uppe 
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SECTOR 



yinil HbtJfc^Mi mim 



CROSS-SECTOR LINKS 



DAP- 16M2 



WM^MWmMh 



IOS-016D 



016-DECL 



10 



11 



12 



13 



SYMLIST 



ASR PACKAGE 



PAPER TAPE PACKAGE 



CARD READER PACKAGE 



LINE PRINTER PACKAGE 



MAGNETIC TAPE 
PACKAGE 

JA^LEST?" 





Figure 7-2. Core Map, After Generating Assembler Syste 
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2000 FORMAT C19H ARITHMETIC MEAN = ,E14.5, 





STG 


"2000 


000213 


JMP 


000000 


000214 


OCT 


124261 


000215 


OCT 


134710 


000216 


OCT 


120301 


000217 


OCT 


15131 1 


000220 


OCT 


152310 


000221 


OCT 


146705 


000222 


OCT 


15231 1 


000223 


OCT 


141640 


000224 


OCT 


146705 


000225 


OCT 


140716 


000226 


OCT 


120275 


000227 


OCT 


120254 


000230 


OCT 


142661 


000231 


OCT 


132256 


000232 


OCT 


132654 


1/22H STANDARD DE^ 


000233 


OCT 


127662 


000234 


OCT 


131310 


000235 


OCT 


120323 


000236 


OCT 


152301 


000237 


OCT 


147304 


000240 


OCT 


140722 


000241 


OCT 


142240 


000242 


OCT 


1 42305 


000243 


OCT 


15331 1 


000244 


OCT 


140724 


000245 


OCT 


144717 


000246 


OCT 


147240 


000247 


OCT 


136640 


000250 


OCT 


126305 


000251 


CCT 


130661 


000252 


OCT 


127265 


000253 


OCT 


124640 




STG 


000213 


RETURN 




000254 


JMP* 


000000 



END 



= *E1 1 .5) 



000255 
000003 
000004 
000005 
000006 
000007 

000256 
000257 

000260 

000261 
000262 
000042 

000263 

000264 

000265 
000266 
000000 

000267 
000270 

000271 
000272 

000273 
000274 
000155 

000275 
000213 

SO 



STG 

OCT 

DAC 

DAC 

DAC 

DAC 

DAC 

STG 

OCT 

OCT 

STG 

OCT 

STG 

OCT 

OCT 

DAC 

STG 

OCT 

STG 

OCT 

STG 

OCT 

OCT 

DAC 

STG 

OCT 

OCT 

STG 

OCT 

OCT 

STG 

OCT 

OCT 

DAC 

STG 

OCT 

DAC 



='000001 

000001 

NRUN 

NPT 

PT 

DEV 

AMEAN 

SX 

120240 

120240 

= '000000 

000000 

SX2 

120240 

131240 

-100 

I 

004640 

TS1000 

012244 

ANPT 

120240 

150324 

S9RT 

TS2000 

130260 

131260 

TS2001 

130261 

131260 

TS2002 

130262 

131260 

-1000 

J 

005240 
-2000 



Figure A-l. Expanded Listing of STDDEV (Cont. ) 
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APPENDIX A 
EXPANDED STDDEV LISTING 



SUBROUTINE STDDEV OMRUN, NPT, PT» DEV> AMEAN) 



000000 
000001 
000003 
000003 
000004 
000005 
000006 
000007 



OCT 

CALL 

OCT 

OCT 

OCT 

OCT 

OCT 

OCT 



000000 

FSAT 

000005 

000000 

000000 

000000 

000000 

000000 



DIMENSION PTC100) 



SX = 



000010 

00001 1 
000012 
000013 
000014 



JtMP 

STG 

LDA 

CALL 

CALL 

DAC 



000000 

000010 

='000000 

CS12 

HS22 

SX 



SX2 = 

000015 LDA 

000016 CALL 

000017 CALL 
000020 DAC 



='000000 
C$12 
HS22 
SX2 



000021 

000022 



DC 100 I = 1>NPT 

LDA ='000001 
STA I 



SX2 



000023 
000024 
000025 
000026 
000027 
000030 
000031 
000032 
000033 
000034 
000035 
000036 
000037 
000040 
000041 



= SX2 + <PTCI))*<PT<I>) 

LDA I 

ALS1 000000 

ADD PT 

ADD 000030 

JMP 0000 31 

OCT 177776 

STA TS1000 

CALL LS22 

DAC* TS1000 

CALL M$22 

DAC* TS1000 

CALL AS22 

DAC SX2 

CALL WB22 

DAC SX2 
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100 sx 


= SX 


+ prcn 


000042 


LOA 


I 


000043 


ALS1 


000000 


000044 


A 00 


PT 


000045 


ADD 


000047 


000046 


JMP 


000050 


000047 


CCT 


1 77776 


000050 


S7A 


TS1000 


000051 


CALL 


LS22 


000052 


DAC* 


TS1000 


000053 


CALL 


AS22 


000054 


OAC 


SX 


000055 


CALL 


H<522 


000056 


DAC 


SX 


000057 


LDA 


I 


000060 


ADD 


='000001 


000061 


CAS* 


NPT 


000062 


JMP 


000065 


000063 


JMP 


000022 


000064 


JMP 


000022 


ANPT = NPT 


000065 


LDA* 


NPT 


000066 


CALL 


C$12 


000067 


CALL 


W522 


000070 


DAC 


ANPT 


OEV 


' = S0RrcSX2/ANPT-CSX/ANPr>*<SX/ANPT>) 


000071 


CALL 


L522 


000072 


DAC 


SX 


000073 


CALL 


0522 


000074 


DAC 


ANPT 


000075 


CALL 


HS22 


000076 


DAC 


TS2000 


000077 


CALL 


M522 


000100 


DAC 


T<62000 


000101 


CALL 


H<B22 


000102 


DAC 


TS2001 


000103 


CALL 


L$22 


000104 


DAC 


SX2 


000105 


CALL 


0S22 


000106 


DAC 


ANPT 


000107 


CALL 


5$22 


0001 10 


DAC 


TS2001 


0001 1 1 


CALL 


HS22 


0001 12 


DAC 


T<B2002 


0001 13 


CALL 


SORT 


0001 14 


DAC 


T-B2002 


0001 15 


CALL 


HS22 


0001 16 


DAC* 


DEV 


AMEA.N = SX/ANPT 


0001 17 


CALL 


L'S22 


000120 


DAC 


SX 


000121 


CALL 


DS22 


000122 


DAC 


ANPT 


000123 


CALL 


HS22 


000124 


DAC* 


AMEAN 



Figure A-l. Expanded Listing of STDDEV (Cont. ) 
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WRITE (1. 


1000) NRUN.I CPTCJ), J = 1,.NPT) 


000125 


CALL 


FSW1 


000126 


DAC 


-1000 


000127 


CALL 


FSAR 


000130 


OCT 


000001 


000131 


DAC* 


N.RLHN 


000132 


LOA 


='000001 


000133 


STA 


J 


000134 


LDA 


J 


000135 


ALS1 


000000 


000136 


ADD 


PT 


000137 


ADD 


000141 


0001 40 


JMP 


000142 


000141 


OCT 


177776 


000142 


STA 


TS1000 


000143 


CALL 


FSAR 


000144 


OCT 


000002 


000145 


DAC* 


TS1000 


0001 46 


LDA 


J 


000147 


ADD 


='000001 


000150 


CAS* 


MPT 


000151 


JMP 


000154 


000152 


JMP 


000133 


000153 


JMP 


0001 33 


000154 


CALL 


FSCB 


1000 FORMAT C////12H RUN NUMBER » 15// CEU. 




STG 


-1000 


000155 


JMP 


000000 


000156 


OCT 


12 4257 


0001 57 


OCT 


127657 


000160 


OCT 


12 7 6 61 


000161 


OCT 


131310 


000162 


OCT 


120322 


000163 


OCT 


1 527 16 


000164 


ccr 


120316 


000165 


C C T 


1 52715 


0001 66 


OCT 


141305 


00167 


OCT 


1 51240 


000170 


CCT 


1262il 


000171 


OCT 


132657 


000172 


OCT 


127650 


000173 


CCT 


142661 


000174 


OCT 


130656 


000175 


OCT 


132254 


000176 


OCT 


132305 


000177 


OCT 


130664 


000200 


OCT 


127264 


000201 


OCT 


124651 




STG 


0001 55 


WRITE CI* 


2000) AMEAN* DEV 


000202 


CALL 


FSW1 


000203 


DAC 


-2000 


000204 


CALL 


FSAR 


000205 


OCT 


000002 


000206 


DAC* 


AMEAN 


000207 


CALL 


FSAR 


000210 


OCT 


000002 


00021 1 


DAC* 


DEV 


000212 


CALL 


FSCB 


Figure 


A-l. Expanded Listing of STDDEV (Cont. ) 
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